is-email-maybe

Sort-of-strong, but also loose email address validator which uses the same regex as Angular 1.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
is-email-maybe
1.0.18 years ago8 years agoMinified + gzip package size for is-email-maybe in KB

Readme

is-email-maybe
Hey, I just met you, and this is crazy, but here's my address. isEmailMaybe? Sort-of-strong, but also loose email address validator which uses the same regex as Angular 1.
!Build Statusbuild-badgebuild !Code Coveragecoverage-badgecoverage !versionversion-badgepackage !downloadsdownloads-badgenpm-stat !MIT Licenselicense-badgeLICENSE All Contributors
!PRs Welcomeprs-badgeprs !Donatedonate-badgedonate !Code of Conductcoc-badgecoc !Roadmaproadmap-badgeroadmap

The problem

Email validation is hard. You'll probably always get it wrong. The most sure way to validate that an email is valid is by sending it something. Most of the time this works great. If someone wants to sign up for you newsletter, you just let them type whatever they want, then you send them an email and ask them to click on a link to validate they got your email.
However, there are some cases where you really need to protect from human error. In my specific scenario, if the user enters an incorrect email, they could send hundreds of dollars to the wrong person. Or think that they paid their bill on time, but find out too late that they made a typo in the email address.
When doing email validation, you should weigh the costs of getting it wrong. If your validation is over-ambitiously validating an email address, that could lead to some serious frustration on the part of the end user and they may not subscribe to your newsletter (for example), so you may as well make validation as loose as possible (don't use this). However, if you have a scenario like mine where a typo can lead to serious mistakes, then a more ambitious validation solution is probably good.

This solution

This is a direct copy/paste from the Angular 1angular code hereangular-code. It's not perfect, but it does a pretty good job of validating 99% of use cases. And it's definitely been battle tested across hundreds of thousands of Angular applications throughout the world.

Installation

This module is distributed via npmnpm which is bundled with nodenode and should be installed as one of your project's dependencies:
npm install --save is-email-maybe

You can also get it from npmcdn.comcdn: https://npmcdn.com/is-email-maybecdn-url

Usage

const isEmailMaybe = require('is-email-maybe')
isEmailMaybe('a@b.c') // true
isEmailMaybe('a@@b.c') // false
isEmailMaybe.regex.test('email@example.com') // true

Other Solutions

Contributors

Thanks goes to these people (emoji keyemojis):
|
Kent C. Dodds

💻 📖 🚇 ⚠️ | | :---: |
This project follows the all-contributorsall-contributors specification. Contributions of any kind welcome!

LICENSE

MIT