fullnameparser

Fast, accurate human name parser with zero dependencies. Handles titles, suffixes, particles, nicknames, and international names.

Benchmark

Tested against 50,000+ diverse names:

Library	Accuracy	Speed
fullnameparser	99%	7ms
parse-full-name	61%	7ms
another-name-parser	54%	56ms
humanparser	44%	9ms

Test data locale distribution:

Script	Coverage
Latin (EN, ES, FR, DE, IT, etc.)	65%
Vietnamese	12%
CJK (Chinese, Japanese, Korean)	8%
Arabic	5%
Cyrillic (Russian, Ukrainian)	4%
Thai	3%
Greek	2%
Hebrew	1%

Installation

npm install fullnameparser

Usage

import { parseName } from 'fullnameparser';

parseName('Dr. Martin Luther King Jr.');
// {
//   title: 'Dr.',
//   first: 'Martin',
//   middle: 'Luther',
//   last: 'King',
//   suffix: 'Jr.',
//   nick: ''
// }

parseName('Dwayne "The Rock" Johnson');
// {
//   title: '',
//   first: 'Dwayne',
//   middle: '',
//   last: 'Johnson',
//   suffix: '',
//   nick: 'The Rock'
// }

parseName('Ludwig van Beethoven');
// {
//   title: '',
//   first: 'Ludwig',
//   middle: '',
//   last: 'van Beethoven',
//   suffix: '',
//   nick: ''
// }

parseName('Kennedy, John F.');
// {
//   title: '',
//   first: 'John',
//   middle: 'F.',
//   last: 'Kennedy',
//   suffix: '',
//   nick: ''
// }

Features

• Zero dependencies - lightweight and fast
• Titles - Mr., Mrs., Dr., Prof., Sir, Lady, Rev., Judge, military ranks, international titles (Señor, Herr, Monsieur, etc.)
• Suffixes - Jr., Sr., III, PhD, MD, MBA, Esq., military, and professional certifications
• Particles - van, von, de, del, la, le, bin, ibn, mac, mc, O', and many more
• Nicknames - "Nick", (Nick), 'Nick' formats
• Comma format - "Last, First Middle" ordering
• Hyphenated names - Jean-Pierre, Zeta-Jones, etc.
• International - Spanish, French, German, Italian, Arabic, Celtic name patterns

API

parseName(fullName: string): ParsedName

Parses a full name string and returns an object with the following properties:

interface ParsedName {
  title: string;   // Dr., Mr., Prof., etc.
  first: string;   // First name
  middle: string;  // Middle name(s)
  last: string;    // Last name (including particles like "van", "de")
  suffix: string;  // Jr., PhD, etc.
  nick: string;    // Nickname
}

License

MIT