Splits a string containing a (Western) person's full name into first and last name components
npm install full-name-splitterHuman names are complicated. They don't necessarily follow any rules. Here's a good article about the complexities of names.
As that article advises, it's ideal to just store a user's full name, and not assume anything about the form the name takes.
However, there are times when it is necessary to have a split given name and family name. Such as when integrating with another system that made different design choices.
This package does a best-guess attempt to split a full name string into given name and family name. For many Western names, it will get it right. It knows about some common family name prefixes used in many European-language names, and initials. It removes salutations (Miss, Doctor, etc) and suffixes (III, Jr, etc).
``js
import { splitter } from 'full-name-splitter';
splitter("George H. W. Bush")
// => ["George H. W.", "Bush"]
splitter("Kevin J. O'Connor")
// => ["Kevin J.", "O'Connor"]
splitter("Thomas G. Della Fave")
// => ["Thomas G.", "Della Fave"]
splitter("Gabriel Van Helsing")
// => ["Gabriel", "Van Helsing"]
// If full name isn't complete, it tries to split partially:
splitter("George W.")
// => ["George W.", null]
splitter("George")
// => ["George", null]
splitter("Van Helsing")
// => [null, "Van Helsing"]
splitter("d'Artagnan")
// => [null, "d'Artagnan"]
`
For other examples see test/src/full-name-splitter.js
If it can't split a name correctly, it is possible to split by comma:
`js
splitter("John Quincy Adams")
// => ["John Quincy", "Adams"]
splitter("John, Quincy Adams")
// => ["John", "Quincy Adams"]
`
The ES6 source (in src/) is transpiled by Babel into lib/ in the npm prepublish hook.
If you're not using this from npm, you'll need to manually trigger transpilation:
`bash``
npm install && npm run prepublish
Original Ruby version created by Pavel Gorbokon, with contributions by Michael S. Klishin and Trevor Creech.
This JavaScript port by Matt Dolan.
Released under the MIT license.