commons-validator-es
TypeScript icon, indicating that this package has built-in type declarations

1.2.0 • Public • Published

commons-validator-es

npm npm bundle size Node.js CI CodeQL Coverage Status

Apache Commons Validator ported to TypeScript as a tree-shakable ES6 module

Usage

Install the library with npm install commons-validator-es

To use as an ES6 module:

import { isEmail } from 'commons-validator-es';

isEmail('test@test.com'); // => true
isEmail('test@test.con'); // => false!

It works as a CommonJS module too, for backwards compatibility

const validator = require('commons-validator-es');

validator.isEmail('test@test.com'); // => true
validator.isEmail('test@test.con'); // => false!

Supported validators

Validator Description
isEmail(email, allowLocal?, allowTld?) Checks if email is a valid email address. Ensures fields like the TLD are valid (no .con!)
If allowLocal is true, emails like test@localhost are valid
If allowTld is true, emails like test@com are valid
isDomain(domain, allowLocal?) Checks if domain is a valid domain name
If allowLocal is true, domains like localhost.localdomain are valid, as are single name labels (like hostname)
isTld(tld, allowLocal?) Checks if tld is a valid tld (.com is allowed but .con is not, for example)
If allowLocal is true, tlds like localdomain are valid
isIpAddress(address) Checks if address is a valid IPv4 or IPv6 address
isIpv4Address(address) Checks if address is a valid IPv4 address
isIpv6Address(address) Checks if address is a valid IPv6 address
isCountryCodeTld(ccTld) Checks if ccTld is a valid country code TLD (like .au)
isGenericTld(gTld) Checks if gTld is a valid generic TLD (like .com)
isInfrastructureTld(iTld) Checks if iTld is a valid infrastructure TLD (only valid is .arpa)
isLocalTld(lTld) Checks if lTld is a valid local TLD (like .localdomain)

Inspiration

commons-validator-js hasn't been updated in a while and does not export an ES6 module. I'll be continuing to add more validators to this to bring it to parity with Apache Commons Validator

Package Sidebar

Install

npm i commons-validator-es

Weekly Downloads

1,096

Version

1.2.0

License

Apache-2.0

Unpacked Size

224 kB

Total Files

12

Last publish

Collaborators

  • iandrewt