@engr-lukman/email-validator NPM

Email Validator

A lightweight, TypeScript-compatible utility for validating email addresses.

Installation

npm install @engr-lukman/email-validator
# or
yarn add @engr-lukman/email-validator
# or
pnpm add @engr-lukman/email-validator

Demo

Check out the interactive Storybook demo to see the component in action.

Features

Validates email addresses with a robust regex pattern
Checks for proper email format with username, @ symbol, and domain
Full TypeScript support with type definitions
Zero dependencies
ES6 module compatible
Built for Node.js 20 LTS or higher and modern browsers

Usage

Basic Usage

// ES Modules / TypeScript
import isValidEmail from '@engr-lukman/email-validator';

// CommonJS
const isValidEmail = require('@engr-lukman/email-validator').default;

// Examples
isValidEmail('user@example.com');           // true
isValidEmail('user.name@example.co.uk');    // true
isValidEmail('user@domain');                // false
isValidEmail('user@.com');                  // false
isValidEmail('@domain.com');                // false
isValidEmail('');                           // false

With Form Validation

import isValidEmail from '@engr-lukman/email-validator';

function validateForm(formData) {
  const errors = {};
  
  if (!formData.email || !isValidEmail(formData.email)) {
    errors.email = 'Please enter a valid email address';
  }
  
  return {
    isValid: Object.keys(errors).length === 0,
    errors
  };
}

// Example usage
const result = validateForm({ email: 'invalid-email' });
console.log(result.errors.email); // "Please enter a valid email address"