is-email-maybe

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

Usage no npm install needed!

<script type="module">
  import isEmailMaybe from 'https://cdn.skypack.dev/is-email-maybe';
</script>

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 Status Code Coverage version downloads MIT License All Contributors

PRs Welcome Donate Code of Conduct Roadmap

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 1 code here. 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 npm which is bundled with node and should be installed as one of your project's dependencies:

npm install --save is-email-maybe

You can also get it from npmcdn.com: https://npmcdn.com/is-email-maybe

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 key):


Kent C. Dodds
💻 📖 🚇 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

LICENSE

MIT