Person

Module to generate people's personal information such as names and job titles. Prior to Faker 8.0.0, this module was known as faker.name.

Overview

To generate a full name, use fullName. Note that this is not the same as simply concatenating firstName and lastName, as the full name may contain a prefix, suffix, or both. Additionally, different supported locales will have differing name patterns. For example, the last name may appear before the first name, or there may be a double or hyphenated first or last name.

You can also generate the parts of a name separately, using prefix, firstName, middleName, lastName, and suffix. Not all locales support all of these parts.

Many of the methods in this module can optionally choose either female, male or mixed names.

Job-related data is also available. To generate a job title, use jobTitle.

This module can also generate other personal information which might appear in user profiles, such as gender, zodiacSign, and bio.

Related modules

For personal contact information like phone numbers and email addresses, see the faker.phone and faker.internet modules.

bio

Returns a random short biography

Available since v8.0.0

Returns: string

function bio(): string;
faker.person.bio() // 'oatmeal advocate, veteran 🐠'

Source

• View Source

firstName

Returns a random first name.

Available since v8.0.0

Parameters

Name	Type	Default	Description
sex?	'female' | 'male'		The optional sex to use. Can be either 'female' or 'male'.

Returns: string

function firstName(sex?: SexType): string;
faker.person.firstName() // 'Antwan'
faker.person.firstName('female') // 'Victoria'
faker.person.firstName('male') // 'Tom'

Source

• View Source

fullName

Generates a random full name.

Available since v8.0.0

Parameters

Name	Type	Default	Description
options	{ ... }	{}	An options object.
options.firstName?	string	faker.person.firstName(sex)	The optional first name to use. If not specified a random one will be chosen.
options.lastName?	string	faker.person.lastName(sex)	The optional last name to use. If not specified a random one will be chosen.
options.sex?	'female' | 'male'	faker.helpers.arrayElement(['female', 'male'])	The optional sex to use. Can be either 'female' or 'male'.

Returns: string

function fullName(
    options: {
      firstName?: string;
      lastName?: string;
      sex?: SexType;
    } = {}
  ): string;
faker.person.fullName() // 'Allen Brown'
faker.person.fullName({ firstName: 'Joann' }) // 'Joann Osinski'
faker.person.fullName({ firstName: 'Marcella', sex: 'female' }) // 'Mrs. Marcella Huels'
faker.person.fullName({ lastName: 'Beer' }) // 'Mr. Alfonso Beer'
faker.person.fullName({ sex: 'male' }) // 'Fernando Schaefer'

Source

• View Source

gender

Returns a random gender.

Available since v8.0.0

Returns: string

function gender(): string;
faker.person.gender() // 'Trans*Man'

See Also

• faker.person.sex(): For generating a binary-gender value.

Source

• View Source

jobArea

Generates a random job area.

Available since v8.0.0

Returns: string

function jobArea(): string;
faker.person.jobArea() // 'Brand'

Source

• View Source

jobDescriptor

Generates a random job descriptor.

Available since v8.0.0

Returns: string

function jobDescriptor(): string;
faker.person.jobDescriptor() // 'Customer'

Source

• View Source

jobTitle

Generates a random job title.

Available since v8.0.0

Returns: string

function jobTitle(): string;
faker.person.jobTitle() // 'Global Accounts Engineer'

Source

• View Source

jobType

Generates a random job type.

Available since v8.0.0

Returns: string

function jobType(): string;
faker.person.jobType() // 'Assistant'

Source

• View Source

lastName

Returns a random last name.

Available since v8.0.0

Parameters

Name	Type	Default	Description
sex?	'female' | 'male'		The optional sex to use. Can be either 'female' or 'male'.

Returns: string

function lastName(sex?: SexType): string;
faker.person.lastName() // 'Hauck'
faker.person.lastName('female') // 'Grady'
faker.person.lastName('male') // 'Barton'

Source

• View Source

middleName

Returns a random middle name.

Available since v8.0.0

Parameters

Name	Type	Default	Description
sex?	'female' | 'male'		The optional sex to use. Can be either 'female' or 'male'.

Returns: string

function middleName(sex?: SexType): string;
faker.person.middleName() // 'James'
faker.person.middleName('female') // 'Eloise'
faker.person.middleName('male') // 'Asher'

Source

• View Source

prefix

Returns a random person prefix.

Available since v8.0.0

Parameters

Name	Type	Default	Description
sex?	'female' | 'male'		The optional sex to use. Can be either 'female' or 'male'.

Returns: string

function prefix(sex?: SexType): string;
faker.person.prefix() // 'Miss'
faker.person.prefix('female') // 'Ms.'
faker.person.prefix('male') // 'Mr.'

Source

• View Source

sex

Returns a random sex.

Output of this method is localised, so it should not be used to fill the parameter sex available in some other modules for example faker.person.firstName().

Available since v8.0.0

Returns: string

function sex(): string;
faker.person.sex() // 'female'

See Also

• faker.person.gender(): For generating a gender related value.
• faker.person.sexType(): For generating a sex value to be used as a parameter.

Source

• View Source

sexType

Returns a random sex type. The SexType is intended to be used in parameters and conditions.

Available since v8.0.0

Returns: 'female' | 'male'

function sexType(): SexType;
faker.person.sexType() // Sex.Female

See Also

• faker.person.gender(): For generating a gender related value in forms.
• faker.person.sex(): For generating a binary-gender value in forms.

Source

• View Source

suffix

Returns a random person suffix.

Available since v8.0.0

Returns: string

function suffix(): string;
faker.person.suffix() // 'DDS'

Source

• View Source

zodiacSign

Returns a random zodiac sign.

Available since v8.0.0

Returns: string

function zodiacSign(): string;
faker.person.zodiacSign() // 'Pisces'

Source

• View Source