Persian FirstName (JSON) 🇮🇷

Package of all Iranian (and Arabic) names

پکیج تمامی اسامی ایرانی (و عربی)

Using:

install:

1npm install persian-names

1yarn install persian-names

import:

1import { PersianNames } from 'persian-names';

require:

1const { PersianNames } = require('persian-names');

new class:

1const persianName = new PersianNames(); //using default json file
2
3const persianName = new PersianNames('./assets/firstname.json'); //using custom json

---

Examples

Validation Persian Name:

1const is_name = persianName.validation('آرش');
2console.log(is_name); //true  or  false

using options

1const is_name = persianName.validation('امیر', {
2  convertToPersian: true,
3  typeCheck: 'exact',
4  trimName: true,
5});
6console.log(is_name); //true  or  false

Get All FirstName:

1const get_names = persianName.getNames();
2console.log(get_names);
3
4/*
5[
6   { id: 1, name: 'اَبدەَ', gender: 1, rate: 3 },
7   { id: 2, name: 'اَبیش', gender: 1, rate: 3 },
8   ...
9]
10*/

using options:

1const get_names = persianName.getNames({
2  genderType: 'stringFa',
3  rateType: 'stringFa',
4  getParamsData: {
5    id: false,
6    name: true,
7    gender: true,
8    rate: true,
9  },
10});
11console.log(get_names);
12/*
13[
14    { name: 'اَبدەَ', gender: 'مرد', rate: 'بسیار نادر' }
15   { name: 'اَبیش', gender: 'مرد', rate: 'بسیار نادر' },
16   ...
17]
18*/

Find Name:

1const find_name = persianName.findName('زهرا');
2console.log(find_name);
3// return { id: 2887, name: 'زهرا', gender: 2, rate: 1 }

using options:

1const find_name = persianName.findName('علی', {
2  myTypeGender: {
3    male: 'مردانه',
4  },
5  typeCheck: 'include',
6});

Get Gender Name:

1const get_gender_name = persianName.getGenderName('سارا', {
2  genderType: 'stringFa',
3});
4console.log(get_gender_name);
5// return { gender: 'زن' }

Include Name:

1const include_name = persianName.includeName(
2  'سلام من رضا هستم به همراه علی و احمد',
3  {
4    // options
5  }
6);
7console.log(include_name);
8/**  return {
9  originalStr: 'سلام من رضا هستم به همراه علی و احمد',
10  findNamesToStr: 'سلام من "رضا" هستم به همراه "علی" و "احمد"',
11  names: [
12    { id: 634, name: 'احمد', gender: 'male', rate: 1 },
13    { id: 2399, name: 'رضا', gender: 'male', rate: 1 },
14    { id: 3652, name: 'علی', gender: 'male', rate: 1 }
15  ],
16  length: 3
17}
18*/

options:

Options	Description	type support	Default
convertToPersian	convert alphabet arabic to persian	boolean,undefined	false
typeCheck	include type or exact type for find name	'exact','include'	exact
trimName	trim name before validation (remove space and A-Z characters and emojis and ...)	boolean,undefined	false
myTypeGender	custom gender (male,female,both) show in result	undefined, male:string, female:string, both:string,	undefined
genderType	convert gender name for show	undefined, genderTypeFa, genderTypeNumber, genderTypeArb,	genderTypeNumber
rateType	convert rate name for show	undefined, rateTypeNumber, rateTypeFa	rateTypeNumber
getParamsData	items that can be displayed in the output	undefined, id:bool, name:bool, gender:bool, rate:bool,	undefined

Rate Types:

value	number	stringFa
1	1	پر کاربردی
2	2	معمولی
3	3	بسیار نادر

Gender Types:

value	Number	Fa	Arb
1	1	مرد	مذکر
2	2	زن	مونث
3	3	هردو	هردو

نکات

1- ممکن است یک سری از نام ها در این کتابخانه وجود نداشته باشد. که شما می توانید از طریق این لینک پروژه تبدیل کننده آن را دریافت کنید: project که این پروژه شامل فایل اکسل آماده اسامی + کد های جاوااسکریپت برای تبدیل فایل اکسل به json است.

2- بعضی از اسامی مانند حشمت و یا احسان و... هم در مردان و هم در زنان استفاده می شود پس این کتابخانه در جواب آن به شما پاسخ 3 و یا هردو و... میدهد.

3-این کتابخانه برای سهولت در توسعه و کار کردن با آن از دیتابیس داخلی یعنی json استفاده می کند.

4- این کتابخانه تا به الان شامل 6179 عدد نام مرد و زن (عربی و فارسی) است.

5- نام هایی مثل محمد و محمدرضا و یا محمدمهدی جدا هستند و جدا حساب می شوند.

---

مشتاق به دریافت پیشنهادات و نظرات دوستان هستم.

✉️ email : hejazi00831@gmail.com

🌐 github : https://github.com/mohammadhejazirad