extract-email-address

extract-email-address 📧

Extracts email address from an arbitrary text input.

• extract-email-address 📧
  • API
  • Usage
  • Filtering results
  • Related projects

API

import {
  extractEmail,
  type EmailMatch,
} from 'extract-email-address';

extractEmail(input: string): readonly EmailMatch[];

Usage

import { extractEmail } from 'extract-email-address';

extractEmail('extracts email from anywhere within the input [e-mail]');
// [{email: '[e-mail]'}]

extractEmail('extracts multiple emails located anywhere within the input: [e-mail], [e-mail]');
// [{email: '[e-mail]'}, {email: '[e-mail]'}]

extractEmail('extracts all sorts of obfuscated emails, e.g. f o o @ b a r . c o m or baz [at] qux [dot] com');
// [{email: '[e-mail]'}, {email: '[e-mail]'}]

extractEmail('extracts tagged emails, e.g. [e-mail]');
// [{email: '[e-mail]'}]

extractEmail('extracts emails surrounded by odd unicode characters, e.g. 邮箱：[e-mail]');
// [{email: '[e-mail]'}]

extractEmail('extracts emails surrounded by emojis, e.g. 📧[e-mail]');
// [{email: '[e-mail]'}]

extractEmail('excludes invalid emails with invalid TLDs, e.g. [e-mail]');
// []

extractEmail('ignores invalid emails foo@bar');
// []

Filtering results

Some matches might be syntactically valid email addresses, but not actual email addresses, e.g. [e-mail].

extract-email-address uses a list of valid top-level domains to filter out matches that are definitely not emails (such as png example), but you might still need to filter out domain specific false-positives.

Related projects

• extract-date – Extracts date from an arbitrary text input.
• extract-price – Extracts price from an arbitrary text input.
• extract-time – Extracts time from an arbitrary text input.