initials
v3.1.2
Published
initials for names
Readme
Initials. Because JD is shorter than John Doe
extracts initials from and adds initials to names
Installation
Install using npm for node.js:
npm install --save initialsUsage
initials('John Doe')
// 'JD'
initials(['John Doe', 'Robert Roe'])
// ['JD', 'RR']
// alias for initials('John Doe')
initials.find('John Doe')
// parse name(s)
initials.parse('John Doe')
// {name: 'John Doe', initials: 'JD'}
// add initials to name(s)
initials.addTo('John Doe')
// 'John Doe (JD)'
// pass existing initials for names
initials(['John Doe', 'Jane Dane'], {
existing: { 'John Doe': 'JD' }
})
// ['JD', 'JDa']Notes
Preffered initials can be passed in (JD), e.g.
console.log( initials('John Doe (JoDo)') );
// 'JoDo'If a name contains an email, it gets ignored when calculating initials
console.log( initials('John Doe [email protected]') );
// 'JD'If a name is an email, the domain part gets ignored
console.log( initials('[email protected]') );
// 'jo'When passing an Array of names, duplicates of initials are avoided
console.log( initials(['John Doe', 'Jane Dane']) );
// ['JDo', 'JDa']Test
npm test