email-validator

A robust TypeScript email validator supporting standard domains and IPv4 literals.

Features

• ✅ Validates standard email addresses: [email protected]
• ✅ Supports subdomains: [email protected]
• ✅ Allows quoted local parts: "user.name"@example.com
• ✅ Supports IPv4 literal domains: user@[123.45.67.89]
• ✅ Strictly invalidates malformed IP addresses in literals
• ✅ Lightweight, fast, and TypeScript-ready

Installation

npm install email-validator

Usage

import { isEmail } from "email-validator";

console.log(isEmail("[email protected]"));      // true
console.log(isEmail("user@[123.45.67.89]"));      // true
console.log(isEmail("user@[999.999.999.999]"));   // false
console.log(isEmail("plainaddress"));             // false

API

isEmail(email: string): boolean

Checks if the given string is a valid email address.

• Parameters:

  • email – The email string to validate.

• Returns:

  • true if valid, false otherwise.

Example

import { isEmail } from "email-validator";

const emails = [
  "[email protected]",
  "invalid-email@com",
  "user@[123.45.67.89]",
  "user@[999.999.999.999]",
];

emails.forEach((email) => {
  console.log(`${email} => ${isEmail(email)}`);
});

Output:

[email protected] => true
invalid-email@com => false
user@[123.45.67.89] => true
user@[999.999.999.999] => false

Contributing

Contributions are welcome! Please submit a pull request or open an issue.

License

MIT License

If you want, I can also add a badge section for npm version, downloads, and license so your README looks more professional on npm.

Do you want me to add that?