nomine-lipsum
TypeScript icon, indicating that this package has built-in type declarations

4.1.0 • Public • Published

Nomine Lipsum

Pick a random name from a list of the most popular names in the United States.

Usage


Just call on one of the object's methods to return a name.

Method Description
full() Generate a random full name
given() Generate any given name
surname() Generate a random surname
male() Generate a male given name
female() Generate a female given name
unisex() Generate a unisex given name
import nomine from 'nomine-lipsum';

// Generate a random, full name
nomine.full(); // Jane Smith

// Generate given (first) names
nomine.given(); // Morgan
nomine.male(); // Michael
nomine.female(); // Theresa
nomine.unisex(); // Terry

// Generate a surname
nomine.surname(); // Smith

Data Sources

All given (first) names are sourced from the United Stats Social Security Administration. More information relating to the dataset can be found on the Background Information for Popular Names page. The National data dataset (used in this generator) is downloaded and extracted. Each year, from 1880 to 2020, has its own unique file which is analyzed for unique names and added to a Set and and a Map thereafter. This ensures no duplication and a quick lookup to tally counts in creating a list of the most popular names and, in particular, unisex names (as data by US SSA has only binary genders).

Surnames are provided by the US Census Bureau. More information on dataset used can be found on the Frequently Occurring Surnames from the 2010 Census page. All of these names are all-caps and some names require minimal formatting in order to appear correct. For example, names of Gaelic origin: McDonald and O'Connor.

Package Sidebar

Install

npm i nomine-lipsum

Weekly Downloads

4

Version

4.1.0

License

MIT

Unpacked Size

77.8 kB

Total Files

6

Last publish

Collaborators

  • mikedpad