Full Name Generator - Generate Random Names
Generate random names effortlessly using various data sources of popular first names and surnames from multiple countries.
If you find this package helpful, please consider โญ starring it on GitHub.
$ npm install full-name-generator --save
import { firstName, lastName, fullName } from 'full-name-generator';
// Generate Full Names
const maleFullName = fullName('US', 0);
const femaleFullName = fullName('US', 1);
// Generate First Names
const maleFirstName = firstName('US', 0);
const femaleFirstName = firstName('US', 1);
// Generate Surnames
const turkishSurname = lastName('TR');
const czechFemaleSurname = lastName('CZ', 1);
// Generate Multiple Names
const twoAmericanMaleFirstNames = firstName('US', 0, 2);
const twoAmericanLastNames = lastName('US', null, 2);
const twoAmericanNamesThreeSurnamesFemaleFullName = fullName('US', 1, 2, 3);
- ๐ฆ๐ท Argentina (AR)
- ๐ฆ๐น Austria (AT)
- ๐ง๐ช Belgium (BE)
- ๐ง๐ท Brazil (BR)
- ๐จ๐ณ China (CN)
- ๐จ๐ฟ Czechia (CZ)
- ๐ฉ๐ฐ Denmark (DK)
- ๐ซ๐ฎ Finland (FI)
- ๐ซ๐ท France (FR)
- ๐ฉ๐ช Germany (DE)
- ๐ฌ๐ท Greece (GR)
- ๐ฎ๐ณ India (IN)
- ๐ฎ๐ฉ Indonesia (ID)
- ๐ฎ๐ฑ Israel (IL)
- ๐ฎ๐น Italy (IT)
- ๐ฏ๐ต Japan (JP)
- ๐ฒ๐ฝ Mexico (MX)
- ๐ณ๐ฑ Netherlands (NL)
- ๐ณ๐ด Norway (NO)
- ๐ต๐ฑ Poland (PL)
- ๐ต๐น Portugal (PT)
- ๐ท๐บ Russia (RU)
- ๐ธ๐ฆ Saudi Arabia (SA)
- ๐ฐ๐ท South Korea (KR)
- ๐ช๐ธ Spain (ES)
- ๐ธ๐ช Sweden (SE)
- ๐น๐ผ Taiwan (TW)
- ๐น๐ญ Thailand (TH)
- ๐น๐ท Tรผrkiye (TR)
- ๐ฌ๐ง United Kingdom (GB)
- ๐บ๐ธ United States (US)
- ๐ป๐ณ Vietnam (VN)
Generates a full name based on the provided parameters.
fullName(isoCode: string, gender: Gender, firstN: number = 1, lastN: number = 1, space: string = ' '): string
- isoCode: The ISO code for the country (e.g., BR, CZ, US).
- gender: Gender category for the name. (0 - Male, 1 - Female).
- firstN: Number of first names to be generated (default is 1).
- lastN: Number of surnames to be generated (default is 1).
- space: Separator between the first names and surnames (default is a single whitespace).
Generates one or more first names based on the provided country code and gender.
firstName(isoCode: string, gender: Gender, n: number = 1): string
- isoCode: The ISO code for the country (e.g., BR, CZ, US).
- gender: Gender category for the name. (0 - Male, 1 - Female).
- n: Number of first names to generate (default is 1).
Generates one or more surnames. For some countries like the Czech Republic or Poland, gender is considered.
lastName(isoCode: string, gender?: Gender, n: number = 1): string
- isoCode: The ISO code for the country (e.g., BR, CZ, US).
- gender: (Optional) Gender category for the surname. Required for countries like the Czech Republic. (0 - Male, 1 - Female).
- n: Number of surnames to generate (default is 1).
The MIT License (MIT). Please see License File for more information.
To reference this project, use the code snippet below:
<a href="https://fullnamegenerator.com">Full Name Generator</a>