Validates email addresses based on regex, common typos, disposable email blacklists, DNS records and SMTP server response.

Validates email format (contains @, . in domain, no spaces or control characters).
Validates common typos e.g. example@gmaill.com using mailcheck.
Validates email was not generated by a disposable email service using disposable-email-domains.
Validates MX records are present on DNS.
Validates SMTP server is running.
Validates mailbox exists on SMTP server.
Sanitizes inputs to prevent SMTP command injection.
Native TypeScript support.

Getting Started

Requires Node.js >= 20. Server-side only (not browser compatible).

Installation

npm install deep-email-validator

Usage

import { validate } from 'deep-email-validator'
const res = await validate('asdf@gmail.com')
// {
//   "valid": false,
//   "reason": "smtp",
//   "validators": {
//       "regex": {
//         "valid": true
//       },
//       "typo": {
//         "valid": true
//       },
//       "disposable": {
//         "valid": true
//       },
//       "mx": {
//         "valid": true
//       },
//       "smtp": {
//         "valid": false,
//         "reason": "Mailbox not found.",
//       }
//   }
// }

You can also pass an options object to control which validations run:

await validate({
  email: 'name@example.org',
  sender: 'name@example.org',
  validateRegex: true,
  validateMx: true,
  validateTypo: true,
  validateDisposable: true,
  validateSMTP: true,
})

Default options can be found here.

Custom TLDs

If you want to validate domains with TLDs that are not supported by default, use the additionalTopLevelDomains option:

await validate({
  email: 'name@example.ir',
  additionalTopLevelDomains: ['ir'],
})

For a list of TLDs supported by default, see mailcheck defaults.

CommonJS usage

const { validate } = require('deep-email-validator')
const res = await validate('asdf@gmail.com')