mootools.mailcheck.js

A rewrite of the jQuery plugin that suggests a right domain when your users misspell it in an email address.

What does it do?

When your user types in "user@hotnail.con", Mailcheck will suggest "user@hotmail.com".

See it live in action on this jsfiddle here.

How to use

This is low level, it works with an element but it does not attach events or handle suggestions. You should extend the class to get that behavior or work with the instance.

Get Mootools. Have a text field.

<input id="email" name="email" type="text" value="dimitar@gogolemail.com" />

Now, attach Mailcheck to the text field. Remember to declare an array of domains you want to check against.

// it can create an instance on the fly for you
var suggested = document.id("email").get("mailcheck").suggest();
if (suggested) {
    // do something with the object
}
else {
    // we have nothing!
}

...or use a proper class instantiation as part of scripting:

// it can create an instance on the fly for you
var mailcheck = new Mailcheck(document.id('email', {
    domains: ["hotmail.com", "gmail.com", "aol.com"],
    threshold: 2,
    method: 'sift3' // sift3 or 'levenstein' (default)
});

document.id("email").addEvent("change", function() {
    var suggested = mailcheck.suggest();
    if (suggested) {
        // do something with the object
    }
    else {
        // we have nothing!
    }
});

A combination of both for quick scripting:

document.id("email").addEvent("change", function() {
    // create a class instance if it does not exist...
    var suggested = this.get("mailcheck").suggest();
    if (suggested) {
        // do something with the object
    }
    else {
        // we have nothing!
    }
});

suggested is an object with the following properties:

{
  user: 'dimitar',               // the address; part before the @ sign
  domain: 'googlemail.com',      // the suggested domain
  full: 'dimitar@googlemail.com' // the full suggested email
}

false is returned when we don't know what to suggest.

Methodology

Mailcheck currently supports the sift3 string similarity / distance algorithm by Siderite and String.levenstein, though the results may vary slightly. Levenstein is now the default as a more reliable result.

Tests

Via Buster.js, go to test/index.html to run.

You can also test via node. To install buster:

# npm install -g buster

To start the static tester:

# buster static

To start in capture mode for multiple browsers:

# buster server &

Once you have captured your target browsers, just run:

# buster test

More details on testing in the tests/README.md, including examples.

Credits

• Original plugin / idea by Derrick Ko (@derrickko)

License

Licensed under the MIT License. You are not allowed to use mailcheck for evil