Installations

npm install deep-email-validator

Pull Requests

Open

22

Total

45

Closed

8

Merged

15

Issues

Open

25

Total

45

Closed

20

Releases

Unable to fetch releases

Developer

mfbx9da4

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

Typescript Support

Yes

Node Version

14.18.2

NPM Version

6.14.15 Statistics

873 Stars

68 Commits

92 Forks

17 Watching

22 Branches

10 Contributors

Updated on 27 Nov 2024

Languages

TypeScript (97.99%)

JavaScript (2.01%)

Total Downloads

Cumulative downloads

Total Downloads

1,897,033

Last day

-17.2%

3,029

Compared to previous day

Last week

7.2%

19,507

Compared to previous week

Last month

-3.2%

73,973

Compared to previous month

Last year

4.2%

763,679

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

4

@types/disposable-email-domains axios disposable-email-domains mailcheck

Dev Dependencies

14

@types/eslint @types/jest @types/lodash @types/mailcheck @types/node @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint jest lodash nodemon ts-jest ts-node typescript

Versions

Email Validator

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

Validates email looks like an email i.e. contains an "@" and a "." to the right of it.
Validates common typos e.g. example@gmaill.com using mailcheck.
Validates email was not generated by 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.
Native typescript support.

Getting Started

Compatible with nodejs only. Not browser ready.

Install like so

npm i deep-email-validator --save

or with yarn

yarn add deep-email-validator

Use like so

1import { validate } from 'deep-email-validator'
2const main = async () => {
3  let res = await validate('asdf@gmail.com')
4  // {
5  //   "valid": false,
6  //   "reason": "smtp",
7  //   "validators": {
8  //       "regex": {
9  //         "valid": true
10  //       },
11  //       "typo": {
12  //         "valid": true
13  //       },
14  //       "disposable": {
15  //         "valid": true
16  //       },
17  //       "mx": {
18  //         "valid": true
19  //       },
20  //       "smtp": {
21  //         "valid": false,
22  //         "reason": "Mailbox not found.",
23  //       }
24  //   }
25  // }
26
27  // Can also be called with these default options
28  await validate({
29    email: 'name@example.org',
30    sender: 'name@example.org',
31    validateRegex: true,
32    validateMx: true,
33    validateTypo: true,
34    validateDisposable: true,
35    validateSMTP: true,
36  })
37}

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

1await validate({
2  email: 'name@example.ir',
3  sender: 'name@example.ir',
4  validateRegex: true,
5  validateMx: true,
6  validateTypo: true,
7  validateDisposable: true,
8  validateSMTP: true,
9  additionalTopLevelDomains: [ 'ir' ]
10})

For a list of TLDs that are supported by default you can see here.

Default options can be found here

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.1

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More