Need help with isemail?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

skeggse
232 Stars 44 Forks Other 118 Commits 7 Opened issues

Description

validate an email address according to RFCs 5321, 5322, and others

Services available

!
?

Need anything else?

Contributors list

# 68,578
yarn
travis-...
Lua
job-que...
49 commits
# 8,059
JavaScr...
Node.js
hapi
hapi-pl...
3 commits
# 458,667
TypeScr...
HTML
3 commits
# 774
GitHub
rust-la...
wechat-...
query-l...
2 commits
# 27,499
CSS
scrolle...
vuejs-c...
Visual ...
2 commits
# 196,627
JavaScr...
1 commit
# 15,661
lodash
ecmascr...
node
test-fr...
1 commit
# 72,342
Go
Shell
Sass
nacl
1 commit
# 632,164
JavaScr...
1 commit
# 132,046
hapi
richtex...
angular...
CSS
1 commit
# 21,206
hapi
Express
jonschl...
Markdow...
1 commit
# 261
TypeScr...
React
gatsby
netlify
1 commit

isemail

Node email address validation library

Build Status[1]

Lead Maintainer: Eli Skeggs

This library is a port of the PHP

is_email
function by Dominic Sayers.

Install

$ npm install isemail

Test

The tests were pulled from

is_email
's extensive test suite on October 15, 2013. Many thanks to the contributors! Additional tests have been added to increase code coverage and verify edge-cases.

Run any of the following.

$ lab
$ npm test
$ make test

remember to

npm install
to get the development dependencies!

API

validate(email, [options])

Determines whether the

email
is valid or not, for various definitions thereof. Optionally accepts an
options
object. Options may include
errorLevel
.

Use

errorLevel
to specify the type of result for
validate()
. Passing a
false
literal will result in a true or false boolean indicating whether the email address is sufficiently defined for use in sending an email. Passing a
true
literal will result in a more granular numeric status, with zero being a perfectly valid email address. Passing a number will return
0
if the numeric status is below the
errorLevel
and the numeric status otherwise.

The

tldBlacklist
option can be either an object lookup table or an array of invalid top-level domains. If the email address has a top-level domain that is in the blacklist, the email will be marked as invalid.

The

tldWhitelist
option can be either an object lookup table or an array of valid top-level domains. If the email address has a top-level domain that is not in the whitelist, the email will be marked as invalid.

The

allowUnicode
option governs whether non-ASCII characters are allowed. Defaults to
true
per RFC 6530.

Only one of

tldBlacklist
and
tldWhitelist
will be consulted for TLD validity.

The

minDomainAtoms
option is an optional positive integer that specifies the minimum number of domain atoms that must be included for the email address to be considered valid. Be careful with the option, as some top-level domains, like
io
, directly support email addresses.

As of

3.1.1
, the
callback
parameter is deprecated, and will be removed in
4.0.0
.

Examples

$ node
> var Isemail = require('isemail');
undefined
> Isemail.validate('[email protected]');
true
> Isemail.validate('[email protected]');
true
> Isemail.validate('[email protected]', {errorLevel: true});
0
> Isemail.validate('[email protected]', {errorLevel: true});
10
> Isemail.validate('[email protected]', {errorLevel: 17});
0
> Isemail.validate('[email protected]', {errorLevel: 10});
10
> Isemail.validate('[email protected]&12');
false
> Isemail.validate('[email protected]&12', {errorLevel: true});
65
> Isemail.validate('[email protected]', {errorLevel: true});
131
> Isemail.validate('[email protected]', {minDomainAtoms: 1}); // default
true
> Isemail.validate('[email protected]', {minDomainAtoms: 2});
false
> Isemail.validate('[email protected]', {minDomainAtoms: 2});
true

[1]: if this badge indicates the build is passing, then isemail has 100% code coverage.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.