humanname

    0.2.2 • Public • Published

    humanname

    JavaScript library to split names into their respective components (first, last, etc)

    Usage:

        // in browser
        var parser = new NameParse();
        var parsed = parser.parse("Mr. Chales P. Wooten, III");
        // in nodejs
        var humanname = require('humanname');
        var parsed = humanname.parse("Mr. Chales P. Wooten, III");

    Results:

    parsed { 
        salutation: "Mr.", 
        firstName: "Charles", 
        initials: "P", 
        lastName: "Wooten", 
        suffix: "III" 
    }
    

    The algorithm:

    We start by splitting the full name into separate words. We then do a dictionary lookup on the first and last words to see if they are a common prefix or suffix. Next, we take the middle portion of the string (everything minus the prefix & suffix) and look at everything except the last word of that string. We then loop through each of those words concatenating them together to make up the first name. While we’re doing that, we watch for any indication of a compound last name. It turns out that almost every compound last name starts with 1 of 15 prefixes (Von, Van, Vere, etc). If we see one of those prefixes, we break out of the first name loop and move on to concatenating the last name. We handle the capitalization issue by checking for camel-case before uppercasing the first letter of each word and lowercasing everything else. I wrote special cases for periods and dashes. We also have a couple other special cases, like ignoring words in parentheses all-together.

    Credits & license:

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0
    

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

    Install

    npm i humanname

    DownloadsWeekly Downloads

    1,566

    Version

    0.2.2

    License

    none

    Last publish

    Collaborators

    • chris-rock