mail-normalize
v1.6.0
Published
A lightweight Node.js library to normalize and sanitize email addresses, handling Gmail aliases and formatting for consistent storage and validation.
Maintainers
Readme
mail-normalize
A lightweight Node.js library to normalize and sanitize email addresses.
Handles Gmail and Hotmail/Outlook aliases and validates email format.
Installation
npm install mail-normalize
# or
pnpm add mail-normalize
yarn add mail-normalize
Usage
normalizeEmail(' [email protected] ');
// → "[email protected]"
normalizeEmail('[email protected]');
// → "[email protected]"
normalizeEmail('[email protected]');
// → "[email protected]"
normalizeEmail('[email protected]');
// → "[email protected]"
normalizeEmail('invalid@@example.com');
// → null
normalizeEmail('[email protected]');
// → "user@☃.com" (IDN decode)
// Opt out of alias stripping when you need the original tag
normalizeEmail('[email protected]', { removeAliases: false });
// → "[email protected]" (dots still removed, alias kept)