Email Validation
Email Validation is a library that validates email addresses and checks againts more than 10K domains used for disposable emails
If you want to block disposable email addresses at signup, or if you are a B2B company and want only professional email adresses, this is the solution for you :)
This library does multiple verifications:
- Email format validation
- Free email address (@gmail.com, @hotmail.com, @protonmail.com, ...)
- Disposable email address (@maildrop.cc, @fakemail.net, @trashmail.com, ...)
- Possible typos in popular email domains
Email Validation has 0 dependency, 100% coverage, and is fully configurable.
Table of Contents
Installation
Install using npm
:
npm install emailvalid
or Yarn yarn
:
yarn add emailvalid
Usage
Email Validation is initialized with a list of default domains
Simple usage example
const EmailValidation = require('emailvalid')
const ev = new EmailValidation()
const result = ev.check('random@gmail.com')
console.log(`${result.email} validity: ${result.valid}`)
const result2 = ev.check('iamadisposableemail@yopmail.com')
console.log(`${result2.email} validity: ${result2.valid}`)
const result3 = ev.check('john@gmil.com')
if (result3.typo) console.log(`Did you mean ${result3.typo}?`)
The output will be an object with some information on the validity (see result section)
Configuration
Email Validation can be configured with more advanced options as an object:
whitelist
(Array) Add some email domains you want to whitelist (default is [])blacklist
(Array) Add some email domains you want to blacklist (default is [])allowFreemail
(Boolean) Allow free emails such as @gmail.com, ... (default is false)allowDisposable
(Boolean) Allow disposable emails such as @trashmail.com, ... (default is false)
You can for example choose to allow freemails, and add a domain baddomain.com in addition to the preconfigured list
Advanced configuration example
const EmailValidation = require('emailvalid')
const ev = new EmailValidation({ allowFreemail: true, blacklist: ['baddomain.com'] })
ev.check('random@gmail.com')
ev.check('paul@baddomain.com')
Or if you want to disallow all free mails, except gmail.com :
const ev = new EmailValidation({ whitelist: ['gmail.com'] })
You can check some examples in example.js
Updating options on the fly
In case you need to update options after initialization, you can do it on the fly with different methods:
whitelist
(Function) Add a new domain to the whitelistblacklist
(Function) Add a new domain to the blacklistsetOptions
(Function) Changes the options
const EmailValidation = require('emailvalid')
const ev = new EmailValidation()
ev.blacklist('baddomain.com')
ev.whitelist('gooddomain.com')
ev.setOptions({ allowFreemail: true })
Result
Email Validation will output an object with the following information:
email
(String) Email in a standardized format (trimed and lowercased)domain
(String) Domain from the emailvalid
(Boolean) Is the email address valid?errors
(Array) List of errors if anytypo
(String) Is there any possible typo in the email?
Errors contains strings and can be one of :
invalid
Email is not present of format is invaliddisposable
Email is disposable (and not whitelisted or allowed in parameters)freemail
Email is a free mail (and not whitelisted or allowed in parameters)blacklisted
Email is blacklisted in parameters
Example :
const EmailValidation = require('emailvalid')
const ev = new EmailValidation()
const result = ev.check('RANDOM@gmail.com')
console.log(result)
Contributions
If you need a simple way to add domains to the list, just run yarn add-domain [DOMAIN] [CATEGORY]
For example yarn add-domain freemail gmail.com
Then feel free to create Pull Requests :)
Licence
MIT License