validator 0.0.3 validator: ^0.0.3 copied to clipboard
String validation and sanitization for Dart.
validator.dart #
String validation and sanitization for Dart.
Build | Tweet |
---|---|
Port of chriso's library.
Usage #
1. Depend on it
Add this to your package's pubspec.yaml
file:
dependencies:
validator: ">=0.0.2 <0.1.0"
2. Install it
You can install packages from the command line:
$ pub get
Alternatively, your editor might support pub. Check the docs for your editor to learn more.
3. Import it
Now in your Dart code, you can use:
import 'package:validator/validator.dart';
Validators #
- equals(String str, comparison) - check if the string matches the comparison.
- contains(String str, seed) - check if the string contains the seed.
- matches(String str, pattern) - check if string matches the pattern.
matches('foobar', 'foo')
. - isEmail(String str) - check if the string is an email.
- isURL(String str [, options]) - check if the string is an URL.
options
is an object which defaults to{ protocols: ['http','https','ftp'], require_tld: true, require_protocol: false, allow_underscores: false, host_whitelist: false, host_blacklist: false }
. - isFQDN(String str [, options]) - check if the string is a fully qualified domain name (e.g. domain.com).
options
is an object which defaults to{ require_tld: true, allow_underscores: false }
. - isIP(String str [, version]) - check if the string is an IP (version 4 or 6).
- isAlpha(String str) - check if the string contains only letters (a-zA-Z).
- isNumeric(String str) - check if the string contains only numbers.
- isAlphanumeric(String str) - check if the string contains only letters and numbers.
- isBase64(String str) - check if a string is base64 encoded.
- isHexadecimal(String str) - check if the string is a hexadecimal number.
- isHexColor(String str) - check if the string is a hexadecimal color.
- isLowercase(String str) - check if the string is lowercase.
- isUppercase(String str) - check if the string is uppercase.
- isInt(String str) - check if the string is an integer.
- isFloat(String str) - check if the string is a float.
- isDivisibleBy(String str, number) - check if the string is a number that's divisible by another.
- isNull(String str) - check if the string is null.
- isLength(String str, min [, max]) - check if the string's length falls in a range. Note: this function takes into account surrogate pairs.
- isByteLength(String str, min [, max]) - check if the string's length (in bytes) falls in a range.
- isUUID(String str [, version]) - check if the string is a UUID (version 3, 4 or 5).
- isDate(String str) - check if the string is a date.
- isAfter(String str [, date]) - check if the string is a date that's after the specified date (defaults to now).
- isBefore(String str [, date]) - check if the string is a date that's before the specified date.
- isIn(String str, values) - check if the string is in a array of allowed values.
- isCreditCard(String str) - check if the string is a credit card.
- isISBN(String str [, version]) - check if the string is an ISBN (version 10 or 13).
- isJSON(String str) - check if the string is valid JSON (note: uses JSON.parse).
- isMultibyte(String str) - check if the string contains one or more multibyte chars.
- isAscii(String str) - check if the string contains ASCII chars only.
- isFullWidth(String str) - check if the string contains any full-width chars.
- isHalfWidth(String str) - check if the string contains any half-width chars.
- isVariableWidth(String str) - check if the string contains a mixture of full and half-width chars.
- isSurrogatePair(String str) - check if the string contains any surrogate pairs chars.
- isMongoId(String str) - check if the string is a valid hex-encoded representation of a [MongoDB ObjectId][mongoid].
Sanitizers #
Method | Description | Status |
---|---|---|
toString(input) | convert the input to a string. | x |
toDate(input) | convert the input to a date, or null if the input is not a date. |
x |
toFloat(input) | convert the input to a float, or NaN if the input is not a float. |
x |
toInt(input [, radix]) | convert the input to an integer, or NaN if the input is not an integer. |
x |
toBoolean(input [, strict]) | convert the input to a boolean. Everything except for '0' , 'false' and '' returns true . In strict mode only '1' and 'true' return true . |
x |
trim(input [, chars]) | trim characters (whitespace by default) from both sides of the input. | x |
ltrim(input [, chars]) | trim characters from the left-side of the input. | x |
rtrim(input [, chars]) | trim characters from the right-side of the input. | x |
escape(input) | replace < , > , & , ' and " with HTML entities. |
x |
stripLow(input [, keep_new_lines]) | remove characters with a numerical value < 32 and 127, mostly control characters. If keep_new_lines is true , newline characters are preserved (\n and \r , hex 0xA and 0xD ). Unicode-safe in JavaScript. |
x |
whitelist(input, chars) | remove characters that do not appear in the whitelist. The characters are used in a RegExp and so you will need to escape some chars, e.g. whitelist(input, '\[\]'). | x |
blacklist(input, chars) | remove characters that appear in the blacklist. The characters are used in a RegExp and so you will need to escape some chars, e.g. blacklist(input, '\[\]'). | |
normalizeEmail(email [, options]) | canonicalize an email address. options is an object which defaults to { lowercase: true } . With lowercase set to true , the local part of the email address is lowercased for all domains; the hostname is always lowercased and the local part of the email address is always lowercased for hosts that are known to be case-insensitive (currently only GMail). Normalization follows special rules for known providers: currently, GMail addresses have dots removed in the local part and are stripped of tags (e.g. some.one+tag@gmail.com becomes someone@gmail.com ) and all @googlemail.com addresses are normalized to @gmail.com . |
x |