mailchecker

What is mailchecker?

The mailchecker npm package is used to validate email addresses and check if they belong to disposable email providers. This can be useful for preventing users from signing up with temporary email addresses that may be used for spam or fraudulent activities.

What are mailchecker's main functionalities?

Validate Email Address

This feature allows you to check if an email address is valid and not from a disposable email provider. The `isValid` method returns a boolean indicating the validity of the email.

const mailchecker = require('mailchecker');

const email = '[e-mail]';
const isValid = mailchecker.isValid(email);
console.log(`Is the email valid? ${isValid}`);

Check Disposable Email

This feature allows you to specifically check if an email address is from a disposable email provider. The `isDisposable` method returns a boolean indicating whether the email is disposable.

const mailchecker = require('mailchecker');

const email = '[e-mail]';
const isDisposable = mailchecker.isDisposable(email);
console.log(`Is the email disposable? ${isDisposable}`);

Other packages similar to mailchecker

email-verifier

The email-verifier package provides email verification and validation services. It checks the syntax, domain, and mailbox existence. Compared to mailchecker, it offers more comprehensive email validation features, including SMTP checks.

disposable-email-domains

The disposable-email-domains package provides a list of disposable email domains. It is a simpler package compared to mailchecker, focusing solely on identifying disposable email domains without additional validation features.

email-existence

The email-existence package checks if an email address exists by connecting to the mail server. It provides a more in-depth validation compared to mailchecker, which primarily focuses on identifying disposable emails.

README

MailChecker

Cross-language email validation. Backed by a database of 1987 throwable email providers.

• Validate the format of your email (uses validator.js email regex underneath and FILTER_VALIDATE_EMAIL for PHP)
• Validate if the email is not a temporary mail (yopmail-like..., add your own dataset to list.json)

This will be very helpful when you have to contact your users and you want to avoid errors causing lack of communication or want to block "spamboxes".

---

Looking for a free Redis administration & monitoring service?

Create your free account on Redsmin

---

MailChecker currently supports:

• NodeJS (CommonJS)
• JavaScript (Client-Side)
• PHP
• Python
• Ruby
• Elixir
• Clojure
• Easily add support for your own language with MailChecker template system and send us a pull-request!

---

Usage

NodeJS

var MailChecker = require('mailchecker');

if(!MailChecker('[e-mail]')){
  console.error('O RLY !');
  process.exit(1);
}

if(!MailChecker('myemail.com')){
  console.error('O RLY !');
  process.exit(1);
}

JavaScript

<script type="text/javascript" src="MailChecker/platform/javascript/MailChecker.js"></script>
<script type="text/javascript">
if(!MailChecker('[e-mail]')){
  console.error('O RLY !');
}

if(!MailChecker('myemail.com')){
  console.error('O RLY !');
}
</script>

PHP

include __DIR__."/MailChecker/platform/php/MailChecker.php";

if(!MailChecker('[e-mail]')){
  die('O RLY !');
}

if(!MailChecker('myemail.com')){
  die('O RLY !');
}

Elixir

Code.require_file("mail_checker.ex", "mailchecker/platform/elixir/")

unless MailChecker.valid?("[e-mail]") do
  raise "O RLY !"
end

unless MailChecker.valid?("myemail.com") do
  raise "O RLY !"
end

Python

# no package yet; just drop in MailChecker.py where you want to use it.
import MailChecker
m = MailChecker.MailChecker()

if not m.is_valid('[e-mail]'):
    print "O RLY !"

Ruby

require 'mail_checker'

unless MailChecker('[e-mail]')
  fail('O RLY!')
end

unless MailChecker.valid?('[e-mail]')
  fail('O RLY!')
end

Clojure

; no package yet; just drop in mailchecker.clj where you want to use it.
(load-file "platform/clojure/mailchecker.clj")

(if (not (mailchecker/valid? "[e-mail]"))
  (throw (Throwable. "O RLY!")))

(if (not (mailchecker/valid? "myemail.com"))
  (throw (Throwable. "O RLY!")))

---

Installation

NodeJS/JavaScript

npm install mailchecker

Ruby

gem install ruby-mailchecker

We accept pull-requests for other package manager.

Data sources

TorVPN

  $('td', 'table:last').map(function(){
    return this.innerText;
  }).toArray();

BloggingWV

  Array.prototype.slice.call(document.querySelectorAll('.entry > ul > li a')).map(function(el){return el.innerText});

... please add your own dataset to list.json.

Regenerate libraries from list.json

Just run (requires NodeJS):

npm run build

Donate

I maintain this project in my free time, if it helped you please support my work via paypal, thanks a lot!

Changelog

License

Copyright (c) Francois-Guillaume Ribreau Licensed under the MIT license.