addressparser

addressparser

Parse e-mail address fields. Input can be a single address ("[e-mail]"), a formatted address ("Andris Reinman <[e-mail]>"), comma separated list of addresses ("[e-mail], [e-mail]"), an address group ("disclosed-recipients:[e-mail];") or a mix of all the formats.

In addition to comma the semicolon is treated as the list delimiter as well (except when used in the group syntax), so a value "[e-mail]; [e-mail]" is identical to "[e-mail], [e-mail]".

Installation

Install with npm

npm install addressparser

Usage

Include the module

var addressparser = require('addressparser');

Parse some address strings with addressparser(field)

var addresses = addressparser('andris <[e-mail]>');
console.log(addresses); // [{name: "andris", address:"[e-mail]"}]

And when using groups

addressparser('Composers:"Bach, Sebastian" <[e-mail]>, [e-mail] (Mozzie);');

the result would be

[
    {
        name: "Composers",
        group: [
            {
                address: "[e-mail]",
                name: "Bach, Sebastian"
            },
            {
                address: "[e-mail]",
                name: "Mozzie"
            }
        ]
    }
]

Be prepared though that groups might be nested.

Notes

This module does not decode any mime-word or punycode encoded strings, it is only a basic parser for parsing the base data, you need to decode the encoded parts later by yourself

License

MIT