Skip to main content
Version: 2.2.0

From an array

Sometimes the parts are already split — they came out of a form, a CSV row, an LDAP attribute, the parts of a URL. Hand them in as a string array and skip the separator dance:

import { Namefully } from 'namefully';

new Namefully(['Jane', 'Doe']);                       // first + last
new Namefully(['Jane', 'Marie', 'Doe']);              // first + middle + last
new Namefully(['Ms', 'Jane', 'Marie', 'Doe']);        // prefix + first + middle + last
new Namefully(['Ms', 'Jane', 'Marie', 'Doe', 'PhD']); // prefix + first + middle + last + suffix

The array is treated positionally, biased by orderedBy. With the default FIRST_NAME order:

LengthMapping
2[first, last]
3[first, middle, last]
4[prefix, first, middle, last]
5[prefix, first, middle, last, suffix]

Switching the order​

import { Namefully, NameOrder } from 'namefully';

new Namefully(['Edison', 'Thomas'], {
  orderedBy: NameOrder.LAST_NAME,
});
// first: Thomas, last: Edison

When the array shape isn't enough​

If you have, say, eight strings and you want to declare which slot each one goes into, skip the positional convention and use NameIndex or NameBuilder.