# validator **Repository Path**: longfeng20/validator ## Basic Information - **Project Name**: validator - **Description**: This library validates and sanitizes strings only. - **Primary Language**: JavaScript - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2023-05-12 - **Last Updated**: 2023-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # validator ## 简介 本demo是基于openHarmony系统下使用三方js库validator.js,validator.js是字符串验证器和清理器的库。 ## 下载安装 ```ts ohpm install validator ``` - OpenHarmony ohpm环境配置等更多内容，请参考 [如何安装OpenHarmony ohpm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_har_usage.md) 。 ## 使用说明 ```ts import validator from 'validator'; let result:boolean = validator.isBase32("ZG======") let result1:boolean = validator.isAscii("foobar") ``` ## 接口说明 ### validator.js 以下是当前可用的验证器列表。 | 验证器 | 描述 | |-----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **contains(str, seed [, options])** | 检查字符串是否包含seed。

`options` 是一个默认为 `{ ignoreCase: false, minOccurrences: 1 }`的对象。
Options:
`ignoreCase`: 进行比较时忽略大小写，默认为false。
`minOccurences`: 字符串中seed的最小出现次数。默认值为1。 | | **equals(str, comparison)** | 检查字符串是否与比较结果匹配。 | | **isAfter(str [, options])** | 检查字符串是否在指定日期之后。

`options` 是一个默认为 `{ comparisonDate: Date().toString() }`的对象。
**Options:**
`comparisonDate`: 要进行比较的日期。默认为 `Date().toString()` (现在). | | **isAlpha(str [, locale, options])** | 检查字符串是否仅包含字母（a-zA-Z）。

`locale` 是其中之一 `['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'bn', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa-IR', 'fi-FI', 'fr-CA', 'fr-FR', 'he', 'hi-IN', 'hu-HU', 'it-IT', 'ko-KR', 'ja-JP', 'ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'si-LK', 'sl-SI', 'sk-SK', 'sr-RS', 'sr-RS@latin', 'sv-SE', 'th-TH', 'tr-TR', 'uk-UA']` 并且默认为 `en-US`. Locale 列表是 `validator.isAlphaLocales`. `options` 是一个可选对象，可以提供以下键： `ignore`， 它可以是要忽略的字符的String或RegExp，例如 " -" 将忽略空格和 -。 | | **isAlphanumeric(str [, locale, options])** | 检查字符串是否只包含字母和数字（a-zA-Z0-9）。

`locale` 是其中之一 `['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bn', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa-IR', 'fi-FI', 'fr-CA', 'fr-FR', 'he', 'hi-IN', 'hu-HU', 'it-IT', 'ko-KR', 'ja-JP','ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'si-LK', 'sl-SI', 'sk-SK', 'sr-RS', 'sr-RS@latin', 'sv-SE', 'th-TH', 'tr-TR', 'uk-UA']`)并且默认为 `en-US`. Locale 列表是 `validator.isAlphanumericLocales`. `options` 是一个可选对象，可以提供以下键： `ignore`， 它可以是要忽略的字符的String或RegExp，例如 " -" 将忽略空格和 -。 | | **isAscii(str)** | 检查字符串是否仅包含ASCII字符。 | | **isBase32(str [, options])** | 检查字符串是否为base32编码。 `options` 是一个默认为 `{ crockford: false }`的对象。
当 `crockford` 为true时，它使用 [Crockford's base32 alternative](http://www.crockford.com/base32.html) 测试给定的base32编码字符串。 | | **isBase58(str)** | 检查字符串是否为base58编码。 | | **isBase64(str [, options])** | 检查字符串是否为base64编码。 `options` 是一个可选项，默认为 `{ urlSafe: false }`
当 `urlSafe` 为 true 时， 它测试给定的base64编码字符串是 [url safe](https://base64.guru/standards/base64url)。 | | **isBefore(str [, date])** | 检查字符串是否为指定日期之前的日期。 | | **isBIC(str)** | 检查字符串是BIC（银行识别码）还是SWIFT代码。 | | **isBoolean(str [, options])** | 检查字符串是否为布尔值。
`options` 是一个默认为 `{ loose: false }`的对象。 如果 `loose` 设置为 false, 验证器将严格匹配 ['true', 'false', '0', '1']. 如果 `loose` 设置为 true, 验证器还将匹配“yes”、“no”，并且将匹配任何情况下的有效布尔字符串。 (例如: ['true', 'True', 'TRUE']). | | **isBtcAddress(str)** | 检查字符串是否为有效的BTC地址。 | | **isByteLength(str [, options])** | 检查字符串的长度（UTF-8字节）是否在某个范围内。

`options` 是一个默认为 `{ min: 0, max: undefined }`的对象。 | | **isCreditCard(str [, options])** | 检查字符串是否为信用卡号。

`options` 是一个可选对象，可以使用以下键提供： `provider` 是一个可选键，其值应为字符串， 并定义了发行信用卡的公司。有效值包括 `['amex', 'dinersclub', 'discover', 'jcb', 'mastercard', 'unionpay', 'visa']` 或空白将检查任何提供商。 | | **isCurrency(str [, options])** | 检查字符串是否为有效的货币金额。

`options` 是一个默认为 `{ symbol: '$', require_symbol: false, allow_space_after_symbol: false, symbol_after_digits: false, allow_negatives: true, parens_for_negatives: false, negative_sign_before_digits: false, negative_sign_after_digits: false, allow_negative_sign_placeholder: false, thousands_separator: ',', decimal_separator: '.', allow_decimal: true, require_decimal: false, digits_after_decimal: [2], allow_space_after_digits: false }`的对象。
**注意:** 数组 `digits_after_decimal` 填充了允许的确切位数，而不是范围，例如范围1到3将被给定为[1，2，3]。 | | **isDataURI(str)** | 检查字符串是否为 [data uri format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)。 | | **isDate(str [, options])** | 检查字符串是否为有效日期。 例如： [`2002-07-15`, new Date()].

`options` 是一个可以包含键 `format`, `strictMode` and/or `delimiters`的对象。

`format` 是一个默认为 `YYYY/MM/DD`的字符串。

`strictMode` 是一个默认为 `false`的布尔值。 如果 `strictMode` 设置为 true, 验证器将拒绝不同于 `format`的字符串。

`delimiters` `是一个允许的日期分隔符数组，默认为`['/', '-']`。 | | **isDecimal(str [, options])** | 检查字符串是否表示十进制数，例如0.1、.3、1.1、1.00003、4.0等。

`options` 是一个默认为 `{force_decimal: false, decimal_digits: '1,', locale: 'en-US'}`的对象。

`locale` 确定十进制分隔符，是 `['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa', 'fa-AF', 'fa-IR', 'fr-FR', 'fr-CA', 'hu-HU', 'id-ID', 'it-IT', 'ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pl-Pl', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sr-RS', 'sr-RS@latin', 'sv-SE', 'tr-TR', 'uk-UA', 'vi-VN']`之一。
**注意:** `decimal_digits` 被给定为一个范围，如'1,3'，一个特定值，如'3'或min'，如'1'。 | | **isDivisibleBy(str, number)** | 检查字符串是否是一个可以被另一个整除的数字。 | | **isEAN(str)** | 检查字符串是否为 [EAN (European Article Number)](https://en.wikipedia.org/wiki/International_Article_Number)。 | | **isEmail(str [, options])** | 检查字符串是否为电子邮件。

`options` 是一个默认为 `{ allow_display_name: false, require_display_name: false, allow_utf8_local_part: true, require_tld: true, allow_ip_domain: false, domain_specific_validation: false, blacklisted_chars: '', host_blacklist: [] }`的对象。 如果 `allow_display_name` 设置为 true, 验证器还将匹配 `Display Name `. 如果 `require_display_name` 设置为 true, 验证器将拒绝没有 `Display Name `格式的字符串。 如果 `allow_utf8_local_part` 设置为 false, 验证器将不允许在电子邮件地址的本地部分中使用任何非英语UTF8字符。 如果 `require_tld` 设置为 false, 域中没有TLD的电子邮件地址也将匹配。 如果 `ignore_max_length` 设置为 true, 验证器不会检查电子邮件的标准最大长度。 如果 `allow_ip_domain` 设置为 true, 验证器将允许主机部分中的IP地址。 如果 `domain_specific_validation` 是 true, 将启用一些额外的验证，例如，禁止某些被Gmail拒绝的语法有效的电子邮件地址。 如果 `blacklisted_chars` 接收一个字符串, 那么验证器将拒绝在名称部分包含字符串中任何字符的电子邮件。 如果 `host_blacklist` 被设置为字符串数组，并且 `@` 符号之后的电子邮件部分与其中定义的字符串之一匹配后，电子邮件的部分将失败。 如果 `host_whitelist` 被设置为一个字符串数组，并且电子邮件中 `@` 符号后的部分与其中定义的任何字符串都不匹配，则验证失败。 | | **isEmpty(str [, options])** | 检查字符串的长度是否为零。

`options` 是一个默认为 `{ ignore_whitespace: false }`的对象。 | | **isEthereumAddress(str)** | 检查字符串是否为 [Ethereum](https://ethereum.org/zh/) 地址。不验证地址校验和。 | | **isFloat(str [, options])** | 检查字符串是否为浮点值。

`options` 是一个对象，它可以包含 `min`, `max`, `gt`和/或 `lt` 来验证 float 是否在边界内 (例如： `{ min: 7.22, max: 9.55 }`) 它也有 `locale` 作为选项。

`min` 和 `max` 分别相当于 '大于或等于' and '小于或等于', 而 `gt` and `lt` 是它们的严格对应物。

`locale` 设置确定十进制分隔符，并且是 `['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fr-CA', 'fr-FR', 'hu-HU', 'it-IT', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sr-RS', 'sr-RS@latin', 'sv-SE', 'tr-TR', 'uk-UA']`之一。 Locale 列表是 `validator.isFloatLocales`。 | | **isFQDN(str [, options])** | 检查字符串是否是完全限定的域名（例如domain.com）。

`options` 是一个默认为 `{ require_tld: true, allow_underscores: false, allow_trailing_dot: false, allow_numeric_tld: false, allow_wildcard: false, ignore_max_length: false }`的对象。 如果 `allow_wildcard` 设置为 true, 则验证器将允许域以 `*.`开头 (例如 `*.example.com` 或 `*.shop.example.com`)。 | | **isFullWidth(str)** | 检查字符串是否包含任何全角字符。 | | **isHalfWidth(str)** | 检查字符串是否包含任何半角字符。 | | **isHash(str, algorithm)** | 检查字符串是否是算法类型的哈希。

Algorithm 是 `['crc32', 'crc32b', 'md4', 'md5', 'ripemd128', 'ripemd160', 'sha1', 'sha256', 'sha384', 'sha512', 'tiger128', 'tiger160', 'tiger192']`之一. | | **isHexadecimal(str)** | 检查字符串是否为十六进制数字。 | | **isHexColor(str)** | 检查字符串是否为十六进制颜色。 | | **isHSL(str)** | 检查字符串是否是基于 [CSS Colors Level 4 specification](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value) 的HSL （色调、饱和度、亮度、可选alpha）颜色。

支持逗号分隔格式。支持空格分隔格式，少数边缘情况除外 (例如: `hsl(200grad+.1%62%/1)`). | | **isIBAN(str)** | 检查字符串是否为IBAN（国际银行账号）。 | | **isIdentityCard(str [, locale])** | 检查字符串是否为有效的身份证代码。

`locale` 是 `['LK', 'PL', 'ES', 'FI', 'IN', 'IT', 'IR', 'MZ', 'NO', 'TH', 'zh-TW', 'he-IL', 'ar-LY', 'ar-TN', 'zh-CN', 'zh-HK']` 或 `'any'`之一. 如果使用 'any', 函数将检查是否有任何区域设置匹配。

默认为 'any'.
| | **isIMEI(str [, options]))** | 检查该字符串是否是有效的 [IMEI 号码](https://en.wikipedia.org/wiki/International_Mobile_Equipment_Identity)。 IMEI的格式应为##############或###-#######-##########-。

`options` 是一个可以包含 `allow_hyphens`的对象。 默认为第一种格式。 如果 `allow_hyphens` 设置为 true, 那么验证器将验证第二种格式。 | | **isIn(str, values)** | 检查字符串是否在允许值的数组中。 | | **isInt(str [, options])** | 检查字符串是否为整数。

`options` 是一个对象，它可以包含键 `min` 和/或 `max`以检查整数是否在边界内 (例如 `{ min: 10, max: 99 }`). `options` 还可以包含键 `allow_leading_zeroes`, 当设置为 false时， 该键将不允许带前导零的整数值 (例如 `{ allow_leading_zeroes: false }`). 最后, `options` 还可以包含键 `gt` 和/或 `lt` 它们将强制整数分别大于或小于所提供的值 (例如，对于1和4之间的数字， `{gt: 1, lt: 4}`)。 | | **isIP(str [, version])** | 检查字符串是否为IP（版本4或6）。 | | **isIPRange(str [, version])** | 检查字符串是否为IP范围（版本4或6）。 | | **isISBN(str [, options])** | 检查字符串是否为ISBN。 [ISBN](https://en.wikipedia.org/wiki/ISBN) 。

`options` 是一个没有默认值的对象。
**Options:**
`version`:要与之比较的ISBN版本。可接受的值为“10”和“13”。 如果没有提供，将对两者进行测试。 | | **isISIN(str)** | 检查字符串是否为 [ISIN](https://en.wikipedia.org/wiki/International_Securities_Identification_Number) (股票/安全标识符)。 | | **isISO6391(str)** | 检查字符串是否为有效的 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)语言代码。 | | **isISO8601(str [, options])** | 检查字符串是否为有效的 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 日期。
`options`是一个默认为 `{ strict: false, strictSeparator: false }`的对象。 如果 `strict` 是 true, 则具有无效日期的日期字符串（如2009-02-29）将无效。 如果 `strictSeparator` 是 true, 则日期和时间由T以外的任何字符分隔的日期字符串将无效。 | | **isISO31661Alpha2(str)** | 检查字符串是否为有效的 [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 官方指定的国家代码。 | | **isISO31661Alpha3(str)** | 检查字符串是否为有效的 [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) 官方指定的国家代码。 | | **isISO4217(str)** | 检查字符串是否为有效的 [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 官方指定的国家代码。 | | **isISRC(str)** | 检查字符串是否为 [ISRC](https://en.wikipedia.org/wiki/International_Standard_Recording_Code)。 | | **isISSN(str [, options])** | 检查字符串是否为 [ISSN](https://en.wikipedia.org/wiki/International_Standard_Serial_Number)。

`options` 是一个默认为 `{ case_sensitive: false, require_hyphen: false }`的对象。 如果 `case_sensitive` 是 true, 则拒绝使用小写 `'x'` 作为校验位的ISSN。 | | **isJSON(str [, options])** | 检查字符串是否为有效的 JSON (注意: 使用 JSON.parse).

`options` 是一个默认为 `{ allow_primitives: false }`的对象。 如果 `allow_primitives` 是 true, 则接受基元 'true', 'false' and 'null' 作为有效的JSON值。 | | **isJWT(str)** | 检查字符串是否为有效的 JWT token. | | **isLatLong(str [, options])** | 检查字符串是否是格式为 `lat,long` or `lat, long`的有效经纬度坐标。

`options` 是一个默认为 `{ checkDMS: false }`的对象。 将 `checkDMS` 传递为 `true` 以验证 DMS(度、分和秒) 纬度-经度格式。 | | **isLength(str [, options])** | 检查字符串的长度是否在某个范围内。

`options` 是一个默认为 `{ min: 0, max: undefined }`的对象。 注意: 此函数会考虑代理项对。 | | **isLicensePlate(str, locale)** | 检查字符串是否与某个国家的车牌格式相匹配。

`locale` 是 `['cs-CZ', 'de-DE', 'de-LI', 'en-IN', 'es-AR', 'hu-HU', 'pt-BR', 'pt-PT', 'sq-AL', 'sv-SE']` 或 `'any'`之一。 | | **isLocale(str)** | 检查字符串是否为区域设置。 | | **isLowercase(str)** | 检查字符串是否为小写。 | | **isLuhnNumber(str)** | 检查字符串是否通过了 [Luhn 算法检查](https://en.wikipedia.org/wiki/Luhn_algorithm)。 | | **isMACAddress(str [, options])** | 检查字符串是否为 MAC 地址。

`options` 是一个默认为 `{ no_separators: false }`的对象。 如果 `no_separators` 是 true, 则验证器将允许不使用分隔符的MAC地址。 此外, 它还允许使用连字符、空格或点，例如，'01 02 03 04 05 ab', '01-02-03-04-05-ab' 或 '0102.0304.05ab'. 这些 options 还允许 `eui` 属性指定是否需要根据 EUI-48 或 EUI-64进行验证。 `eui`的可接受值为: 48, 64。 | | **isMagnetURI(str)** | 检查字符串是否为 [Magnet URI format](https://en.wikipedia.org/wiki/Magnet_URI_scheme)。 | | **isMD5(str)** | 检查字符串是否为 MD5 hash.

请注意，您也可以使用 `isHash(str, 'md5')` 函数。 请记住，与其他算法（例如SHA）相比，MD5有一些冲突弱点。 | | **isMimeType(str)** | 检查字符串是否与有效的 [MIME type](https://en.wikipedia.org/wiki/Media_type) 格式匹配。 | | **isMobilePhone(str [, locale [, options]])** | 检查字符串是否是移动电话号码，

`locale` 是一个区域设置数组 (例如 `['sk-SK', 'sr-RS']`) 或其中之一 `['am-Am', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-EH', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-PS', 'ar-SA', 'ar-SY', 'ar-TN', 'ar-YE', 'az-AZ', 'az-LB', 'az-LY', 'be-BY', 'bg-BG', 'bn-BD', 'bs-BA', 'ca-AD', 'cs-CZ', 'da-DK', 'de-AT', 'de-CH', 'de-DE', 'de-LU', 'dv-MV', 'dz-BT', 'el-CY', 'el-GR', 'en-AG', 'en-AI', 'en-AU', 'en-BM', 'en-BS', 'en-BW', 'en-CA', 'en-GB', 'en-GG', 'en-GH', 'en-GY', 'en-HK', 'en-IE', 'en-IN', 'en-JM', 'en-KE', 'en-KI', 'en-KN', 'en-LS', 'en-MO', 'en-MT', 'en-MU', 'en-NG', 'en-NZ', 'en-PG', 'en-PH', 'en-PK', 'en-RW', 'en-SG', 'en-SL', 'en-SS', 'en-TZ', 'en-UG', 'en-US', 'en-ZA', 'en-ZM', 'en-ZW', 'es-AR', 'es-BO', 'es-CL', 'es-CO', 'es-CR', 'es-CU', 'es-DO', 'es-EC', 'es-ES', 'es-HN', 'es-MX', 'es-NI', 'es-PA', 'es-PE', 'es-PY', 'es-SV', 'es-UY', 'es-VE', 'et-EE', 'fa-AF', 'fa-IR', 'fi-FI', 'fj-FJ', 'fo-FO', 'fr-BE', 'fr-BF', 'fr-BJ', 'fr-CD', 'fr-FR', 'fr-GF', 'fr-GP', 'fr-MQ', 'fr-PF', 'fr-RE', 'ga-IE', 'he-IL', 'hu-HU', 'id-ID', 'ir-IR', 'it-IT', 'it-SM', 'ja-JP', 'ka-GE', 'kk-KZ', 'kl-GL', 'ko-KR', 'ky-KG', 'lt-LT', 'mg-MG', 'mn-MN', 'ms-MY', 'my-MM', 'mz-MZ', 'nb-NO', 'ne-NP', 'nl-AW', 'nl-BE', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-AO', 'pt-BR', 'pt-PT', 'ro-Md', 'ro-RO', 'ru-RU', 'si-LK', 'sk-SK', 'sl-SI', 'sq-AL', 'sr-RS', 'sv-SE', 'tg-TJ', 'th-TH', 'tk-TM', 'tr-TR', 'uk-UA', 'uz-UZ', 'vi-VN', 'zh-CN', 'zh-HK', 'zh-MO', 'zh-TW']` 或默认为 `'any'`. 如果使用 'any'或 false 值, 函数将检查是否有任何 locales 匹配 ).

`options` 是一个可选对象，可以使用以下键提供: `strictMode`, 如果设置为 `true`, 则手机号码必须提供国家/地区代码，因此必须以 `+`开头。 Locale 列表是 `validator.isMobilePhoneLocales`。 | | **isMongoId(str)** | 检查该字符串是否是 [MongoDB ObjectId](http://docs.mongodb.org/manual/reference/object-id/) 的有效十六进制编码表示。 | | **isMultibyte(str)** | 检查字符串是否包含一个或多个多字节字符。 | | **isNumeric(str [, options])** | 检查字符串是否只包含数字。

`options` 是一个默认为 `{ no_symbols: false }`的对象， 它也有 `locale` 作为一个选项. 如果 `no_symbols` 是 true, 验证器将拒绝以符号为特征的数字字符串 (例如 `+`, `-`, 或 `.`).

`locale` 确定十进制分隔符，并且是 `['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fr-FR', 'fr-CA', 'hu-HU', 'it-IT', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sr-RS', 'sr-RS@latin', 'sv-SE', 'tr-TR', 'uk-UA']`其中之一。 | | **isOctal(str)** | 检查字符串是否为有效的八进制数。 | | **isPassportNumber(str, countryCode)** | 检查字符串是否是有效的护照号码。

`countryCode` 是 `['AM', 'AR', 'AT', 'AU', 'AZ', 'BE', 'BG', 'BY', 'BR', 'CA', 'CH', 'CN', 'CY', 'CZ', 'DE', 'DK', 'DZ', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IN', 'IR', 'ID', 'IS', 'IT', 'JM', 'JP', 'KR', 'KZ', 'LI', 'LT', 'LU', 'LV', 'LY', 'MT', 'MX', 'MY', 'MZ', 'NL', 'NZ', 'PH', 'PK', 'PL', 'PT', 'RO', 'RU', 'SE', 'SL', 'SK', 'TH', 'TR', 'UA', 'US']`其中之一。 | | **isPort(str)** | 检查字符串是否为有效的端口号。 | | **isPostalCode(str, locale)** | 检查字符串是否为邮政编码。

`locale` 是 `['AD', 'AT', 'AU', 'AZ', 'BA', 'BE', 'BG', 'BR', 'BY', 'CA', 'CH', 'CN', 'CZ', 'DE', 'DK', 'DO', 'DZ', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HT', 'HU', 'ID', 'IE', 'IL', 'IN', 'IR', 'IS', 'IT', 'JP', 'KE', 'KR', 'LI', 'LK', 'LT', 'LU', 'LV', 'MG', 'MT', 'MX', 'MY', 'NL', 'NO', 'NP', 'NZ', 'PL', 'PR', 'PT', 'RO', 'RU', 'SA', 'SE', 'SG', 'SI', 'SK', 'TH', 'TN', 'TW', 'UA', 'US', 'ZA', 'ZM']` 或 `'any'`其中之一。 如果使用 'any', 函数将检查是否有任何 locales 匹配。 Locale 列表是 `validator.isPostalCodeLocales`. | | **isRFC3339(str)** | 检查字符串是否为有效的 [RFC 3339](https://tools.ietf.org/html/rfc3339) 日期。 | | **isRgbColor(str [, includePercentValues])** | 检查字符串是rgb颜色还是rgba颜色。

`includePercentValues` 默认为 `true`。 如果您不想允许设置带有百分比的 `rgb` 或 `rgba` 值, 如 `rgb(5%,5%,5%)`, 或 `rgba(90%,90%,90%,.3)`, 请将其设置为 false。 | | **isSemVer(str)** | 检查该字符串是否为语义版本控制规范（SemVer）。 | | **isSurrogatePair(str)** | 检查字符串是否包含任何代理项对字符。 | | **isUppercase(str)** | 检查字符串是否为大写。 | | **isSlug(str)** | 检查字符串是否为slug类型。 | | **isStrongPassword(str [, options])** | 检查该字符串是否可以被视为强密码。 允许自定义要求或评分规则。 如果 `returnScore` 是 true, 那么函数将返回密码的整数分数，而不是布尔值。
默认 options:
`{ minLength: 8, minLowercase: 1, minUppercase: 1, minNumbers: 1, minSymbols: 1, returnScore: false, pointsPerUnique: 1, pointsPerRepeat: 0.5, pointsForContainingLower: 10, pointsForContainingUpper: 10, pointsForContainingNumber: 10, pointsForContainingSymbol: 10 }` | | **isTime(str [, options])** | 检查字符串是否为有效时间， 例如 [`23:01:59`, new Date().toLocaleTimeString()].

`options` 是一个对象，可以包含按键 `hourFormat` 或 `mode`.

`hourFormat` 是一个键，默认为 `'hour24'`.

`mode` 是一个键，默认为 `'default'`.

`hourFomat` 可以包含值 `'hour12'` 或 `'hour24'`, `'hour24'` 将以24格式验证小时， `'hour12'` 将以12格式验证小时。

`mode` 可以包含值 `'default'` 或 `'withSeconds'`, `'default'` 将验证 `HH:MM` 格式, `'withSeconds'` 将验证 `HH:MM:SS` 格式。 | | **isTaxID(str, locale)** | 检查该字符串是否为有效的税务识别号。 locale 默认是 `en-US`.

关于确切的TIN支持的更多信息，可以在 `src/lib/isTaxID.js`中找到。

支持的 locales: `[ 'bg-BG', 'cs-CZ', 'de-AT', 'de-DE', 'dk-DK', 'el-CY', 'el-GR', 'en-CA', 'en-GB', 'en-IE', 'en-US', 'es-ES', 'et-EE', 'fi-FI', 'fr-BE', 'fr-CA', 'fr-FR', 'fr-LU', 'hr-HR', 'hu-HU', 'it-IT', 'lb-LU', 'lt-LT', 'lv-LV', 'mt-MT', 'nl-BE', 'nl-NL', 'pl-PL', 'pt-BR', 'pt-PT', 'ro-RO', 'sk-SK', 'sl-SI', 'sv-SE' ]`. | | **isURL(str [, options])** | 检查字符串是否为URL。

`options` 是一个默认为`{ protocols: ['http','https','ftp'], require_tld: true, require_protocol: false, require_host: true, require_port: false, require_valid_protocol: true, allow_underscores: false, host_whitelist: false, host_blacklist: false, allow_trailing_dot: false, allow_protocol_relative_urls: false, allow_fragments: true, allow_query_components: true, disallow_auth: false, validate_length: true }`的对象。

`require_protocol` - 如果设置为true，则如果URL中不存在协议，则isURL将返回false。
`require_valid_protocol` - isURL 将检查协议选项中是否存在URL的协议。
`protocols` -使用此选项可以修改有效的协议。
`require_host` - 如果设置为false，isURL将不会检查URL中是否存在host。
`require_port` - 如果设置为true，isURL将检查URL中是否存在端口。
`allow_protocol_relative_urls` - 如果设置为true协议，则允许相对URL。
`allow_fragments` - 如果设置为false，则如果存在片段，isURL将返回false。
`allow_query_components` - 如果设置为false，则如果存在查询组件，isURL将返回false。
`validate_length` - 如果设置为false，isURL将跳过字符串长度验证 (2083个字符是IE最大URL长度)。 | | **isUUID(str [, version])** | 检查字符串是否为 UUID (版本 1, 2, 3, 4 或 5)。 | | **isVariableWidth(str)** | 检查字符串是否包含全角字符和半角字符的混合物。 | | **isVAT(str, countryCode)** | 如果可以对与 `ISO 3166-1 alpha-2` 匹配的给定国家代码进行验证，则检查该字符串是否为有效的 [valid VAT number](https://en.wikipedia.org/wiki/VAT_identification_number) 。

`countryCode` 是 `['AL', 'AR', 'AT', 'AU', 'BE', 'BG', 'BO', 'BR', 'BY', 'CA', 'CH', 'CL', 'CO', 'CR', 'CY', 'CZ', 'DE', 'DK', 'DO', 'EC', 'EE', 'EL', 'ES', 'FI', 'FR', 'GB', 'GT', 'HN', 'HR', 'HU', 'ID', 'IE', 'IL', 'IN', 'IS', 'IT', 'KZ', 'LT', 'LU', 'LV', 'MK', 'MT', 'MX', 'NG', 'NI', 'NL', 'NO', 'NZ', 'PA', 'PE', 'PH', 'PL', 'PT', 'PY', 'RO', 'RS', 'RU', 'SA', 'SE', 'SI', 'SK', 'SM', 'SV', 'TR', 'UA', 'UY', 'UZ', 'VE']`其中之一。 | | **isWhitelisted(str, chars)** | 检查字符串是否仅由白名单 `chars` 中出现的字符组成。 | | **matches(str, pattern [, modifiers])** | 检查字符串是否与模式匹配。

匹配项 `matches('foo', /foo/i)` 或 `matches('foo', 'foo', 'i')`. | 这是当前可用的清理器列表。 | 清理器 | 描述 | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **blacklist(input, chars)** | 删除黑名单中出现的字符。这些字符是在RegExp中使用的，因此您需要转义一些字符，例如 `blacklist(input, '\\[\\]')`. | | **escape(input)** | 将 `<`, `>`, `&`, `'`, `"` 和 `/` 替换成 HTML 实体。 | | **ltrim(input [, chars])** | 从输入的左侧修剪字符。 | | **normalizeEmail(email [, options])** | 将电子邮件地址规范化。 (如果您想预先使用isEmail验证电子邮件，这不会验证输入是否为电子邮件)。

`options` 是一个具有以下关键点和默认值的对象 :
| | **rtrim(input [, chars])** | 从输入的右侧修剪字符。 | | **stripLow(input [, keep_new_lines])** | 删除数值＜32和127的字符，主要是控制字符。如果 `keep_new_lines` 为 `true`, 则保留换行符 (`\n` 和 `\r`, 十六进制 `0xA` 和 `0xD`). JavaScript中的Unicode-safe。 | | **toBoolean(input [, strict])** | 将输入字符串转换为布尔值。 除 `'0'`, `'false'` 和 `''`之外的所有内容都返回 `true`。 在严格模式下，只有 `'1'` 和 `'true'` 返回 `true`。 | | **toDate(input)** | 将输入字符串转换为日期，如果输入不是日期，则转换为 `null` 。 | | **toFloat(input)** | 将输入字符串转换为浮点，如果输入不是浮点，则转换为`NaN` 。 | | **toInt(input [, radix])** | 将输入字符串转换为整数，如果输入不是整数，则转换为 `NaN` 。 | | **trim(input [, chars])** | 修剪输入两边的字符（默认为空白）。 | | **unescape(input)** | 将HTML编码的实体替换为 `<`, `>`, `&`, `'`, `"` 和 `/`。 | | **whitelist(input, chars)** | 删除未出现在白名单中的字符。这些字符是在RegExp中使用的，因此您需要转义一些字符，例如 `whitelist(input, '\\[\\]')`。 | [单元测试用例详情](https://gitee.com/openharmony-tpc/openharmony_tpc_samples/validator/TEST.md) ## 约束与限制 在下述版本验证通过： DevEco Studio: 3.1 Beta2(3.1.0.400), SDK: API9 Release(3.2.11.9) ## 贡献代码 使用过程中发现任何问题都可以提[Issue](https://gitee.com/openharmony-tpc/openharmony_tpc_samples/validator/issues) 给我们，当然，我们也非常欢迎你给我们提[PR](https://gitee.com/openharmony-tpc/rebound/pulls)。 ## 开源协议 本项目基于 [MIT License](https://gitee.com/openharmony-tpc/openharmony_tpc_samples/validator/blob/master/LICENSE)，请自由地享受和参与开源。