validator.js-asserts
v8.2.0
Published
A set of extra asserts for validator.js.
Downloads
50,765
Readme
validator.js-asserts
A set of extra asserts for validator.js.
Status
Installation
Install the package via npm
:
$ npm install --save validator.js-asserts
Peer dependencies
Some asserts require manually installing some peer dependencies. Failing to do so will result in runtime errors, as packages are required dynamically.
Peer dependencies are not listed on package.json
because npm 2 considers them mandatory peer dependencies and, therefore, always installs them, while npm 3 follows a more consensual approach of optional peer dependencies, not installing them by default but generating warning and confusing error messages instead.
You should pin these package's peer dependencies to the ranges listed on the optionalPeerDependencies key of this package's manifest.
Asserts
The following set of extra asserts are provided by this package:
- AbaRoutingNumber (requires
abavalidator
) - BankIdentifierCode (BIC)
- BigNumber (requires
bignumber.js
) - BigNumberEqualTo (requires
bignumber.js
) - BigNumberGreaterThan (requires
bignumber.js
) - BigNumberGreaterThanOrEqualTo (requires
bignumber.js
) - BigNumberLessThan (requires
bignumber.js
) - BigNumberLessThanOrEqualTo (requires
bignumber.js
) - Boolean
- Callback (requires
callback
) - CpfNumber (requires
cpf
) - CreditCard (requires
creditcard
) - CurpNumber (requires
curp
) - Date (requires
moment
for format validation only) - DateDiffGreaterThan (requires
moment
) - DateDiffGreaterThanOrEqualTo (requires
moment
) - DateDiffLessThan (requires
moment
) - DateDiffLessThanOrEqualTo (requires
moment
) - Email (requires
validator
) - EqualKeys
- Hash
- Integer
- InternationalBankAccountNumber (IBAN, requires
iban
) - Ip
- Iso3166Country (requires
isoc
) - Json
- NotEmpty
- NullOr
- NullOrDate
- NullOrBoolean
- NullOrString
- Phone (requires
google-libphonenumber
) - PlainObject
- RfcNumber (requires
validate-rfc
) - TaxpayerIdentificationNumber (TIN, requires
tin-validator
) - UkModulusChecking (requires
uk-modulus-checking
) - Uri (requires
urijs
) - UsSubdivision
- UsZipCode
- Uuid
AbaRoutingNumber
Tests if the value is a valid ABA Routing Number.
BankIdentifierCode (BIC)
Tests if the value is a valid Bank Identifier Code (BIC) as defined in the ISO-9362 standard.
BigNumber
Tests if the value is a valid BigNumber
.
BigNumberEqualTo
Tests if a BigNumber
is equal to a given value.
Arguments
value
(required)
BigNumberGreaterThan
Tests if a BigNumber
is greater than a given threshold.
Arguments
threshold
(required)
BigNumberGreaterThanOrEqualTo
Tests if a BigNumber
is greater than or equal to a given threshold.
Arguments
threshold
(required)
BigNumberLessThan
Tests if a BigNumber
is less than a given threshold.
Arguments
threshold
(required)
BigNumberLessThanOrEqualTo
Tests if a BigNumber
is less than or equal to a given threshold.
Arguments
threshold
(required)
Boolean
Tests if the value is a boolean.
Callback
Allows you to add custom rules by giving a callback function and a custom class.
Arguments
callback
(required) - the callback function.customClass
(required) - the name of the class.
CpfNumber
Tests if the value is valid CPF number.
CreditCard
Tests if the value is a valid credit card number using the Luhn10 algorithm.
CurpNumber
Tests if the value is valid CURP number.
Date
Tests if the value is a valid date.
Arguments
format
(optional) - the format in which the date must be in.
DateDiffGreaterThan
Tests if the difference between two dates is greater than a given threshold.
Arguments
threshold
(required)options
absolute
- whether the comparison should use the absolute value of the measured difference.asFloat
- whether to return the difference rounded down or as float.fromDate
- the date where the diff is measured with. If omitted, defaults tonow
.unit
- the unit of the difference measurement (years
,months
,weeks
,days
,hours
,minutes
andseconds
).
DateDiffGreaterThanOrEqualTo
Tests if the difference between two dates is greater than or equal to a given threshold.
Arguments
threshold
(required)options
absolute
- whether the comparison should use the absolute value of the measured difference.asFloat
- whether to return the difference rounded down or as float.fromDate
- the date where the diff is measured with. If omitted, defaults tonow
.unit
- the unit of the difference measurement (years
,months
,weeks
,days
,hours
,minutes
andseconds
).
DateDiffLessThan
Tests if the difference between two dates is less than a given threshold.
Arguments
threshold
(required)options
absolute
- whether the comparison should use the absolute value of the measured difference.asFloat
- whether to return the difference rounded down or as float.fromDate
- the date where the diff is measured with. If omitted, defaults tonow
.unit
- the unit of the difference measurement (years
,months
,weeks
,days
,hours
,minutes
andseconds
).
DateDiffLessThanOrEqualTo
Tests if the difference between two dates is less than or equal to a given threshold.
Arguments
threshold
(required)options
absolute
- whether the comparison should use the absolute value of the measured difference.asFloat
- whether to return the difference rounded down or as float.fromDate
- the date where the diff is measured with. If omitted, defaults tonow
.unit
- the unit of the difference measurement (years
,months
,weeks
,days
,hours
,minutes
andseconds
).
Tests if the value is a valid email.
EqualKeys
Tests if the object has the exact given set of keys (missing or extra keys are not allowed).
Arguments
keys
(optional) - the keys that the object being tested must equal. If none are defined, no keys will be allowed.
Hash
Tests if the value is a valid hash.
Arguments
algorithm
(required) - the algorithm to test the hash for. Supported algorithms aresha1
,sha256
andsha512
.
Integer
Tests if the value is an integer.
InternationalBankAccountNumber (IBAN)
Tests if the value is a valid International Bank Account Number (IBAN) as defined in the 13616-1 standard.
Ip
Tests if the value is a valid ip (v4 or v6).
Iso3166Country
Tests if the value is a valid ISO-3166 country by alpha-3 code, alpha-2 code, short name or uppercase name. All officially-assigned, transitionally-assigned and user-assigned codes are considered valid.
Json
Tests if the value is valid json.
NotEmpty
Tests if the value is not an empty (empty object, empty array, empty string, etc).
NullOr
Tests if the value is a null
or validates agains the assert received as an argument.
NullOrBoolean
Tests if the value is a null
or boolean
.
NullOrString
Tests if the value is a null
or string
, optionally within some boundaries.
Arguments
boundaries
(optional) -max
and/ormin
boundaries to test the string for.
Phone
Tests if the phone is valid and optionally if it belongs to the given country. The phone can be in the national or E164 formats.
Arguments
countryCode
(optional) - the ISO-3166 alpha-2 country code to test the phone validity in.
PlainObject
Tests if the value is a plain object.
RfcNumber
Tests if the value is a valid RFC number.
TaxpayerIdentificationNumber
Tests if the value is a valid Taxpayer Identification Number (TIN) as defined by the U.S. IRS.
UkModulusChecking
Tests if the given accountNumber
and sortCode
represent a valid Faster Payment Account
.
Uri
Tests if the value is a valid uri
which must contain at least a protocol and a hostname.
Arguments
constraints
(optional) - additional uri parts to test for (e.g.{ is: 'domain', protocol: 'https' }
).
UsSubdivision
Tests if the value is a valid US subdivision or not. By default, codes in the short ("alpha2", e.g. CA
) or full form (e.g. US-CA
) are allowed. All US subdivisions categories are supported: districts
(1), states
(50) and outlying
territories (6).
Arguments
alpha2Only
(optional) - whether to restrict validation to the "alpha2" short code form only.categories
(optional) - a list of categories to restrict code validation to (e.g.['states', 'outlying']
).
UsZipCode
Tests if the value is a valid US zip code.
Uuid
Tests if the value is a valid uuid.
Arguments
version
(optional) - the version to test the uuid for. Supported version are3
,4
and5
. Defaults to test forall
three if omitted.
Usage
The following is an example for the extra ip assert:
const Validator = require('validator.js').Validator;
const is = require('validator.js').Assert.extend(require('validator.js-asserts'));
const validator = new Validator();
// Validate ip `1.3.3.7`.
let violation = validator.validate('1.3.3.7', is.ip());
if (true === violation) {
console.log('"1.3.3.7" is a valid IP'); // => "1.3.3.7" is a valid IP
}
// Validate ip `foo`.
violation = validator.validate('foo', is.ip());
if (true !== violation) {
console.log('"foo" is not a valid IP. Violation:', violation[0].show());
// => "foo" is not a valid IP. Violation: { assert: 'Ip', value: 'foo' }
}
// Make the validation nullable.
violation = validator.validate(null, is.nullOr(is.ip()));
if (true === violation) {
console.log('null is null or a valid IP'); // => null is null or a valid IP
}
Tests
$ npm test
Release process
The release of a version is automated via the release GitHub workflow. Run it by clicking the "Run workflow" button.
License
MIT