util-helpers 4.9.0 → 4.10.2

package/lib/isSwiftCode.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -19,10 +19,20 @@ var reg = /^[A-Z]{6}[A-Z\d]{2}(?:[A-Z\d]{3})?$/;
  * @since 4.9.0
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为 Swift Code
+ * @example
+ *
+ * isSwiftCode('DEUTDEFF') //  true
+ * isSwiftCode('deutdeff') //  false
+ *
+ * isSwiftCode('BKTWTWTP010') //  true
+ * isSwiftCode('010BKTWTWTP') //  false
+ *
+ * isSwiftCode('ICBKCNBJBJM') //  true
+ *
  */
 
 function isSwiftCode(value) {
-  var valueStr = (0, _convertToString["default"])(value);
+  var valueStr = (0, _normalizeString["default"])(value);
   return reg.test(valueStr);
 }
 

package/lib/isTWCard.js

@@ -5,12 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
-// 台湾居民来往大陆通行证正则，支持一次性短期台胞证
-var regTWCard = /^(\d{8}|[\da-z]{10})$/i;
+// 台湾居民来往大陆通行证正则
+var regTWCard = /^\d{8}$/i; // 一次性短期台胞证
+
+var singleRegTWCard = /^[\da-z]{10,12}$/i;
 /**
  * 检测值是否为台湾居民来往大陆通行证，俗称台胞证。
  *
@@ -19,18 +21,30 @@ var regTWCard = /^(\d{8}|[\da-z]{10})$/i;
  * @since 4.0.0
  * @see 参考 {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
  * @param {*} value 要检测的值
+ * @param {Object} [options] 配置项
+ * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证
  * @returns {boolean} 是否为台湾居民来往大陆通行证
  * @example
  * isTWCard('12345678') // true
  * isTWCard('07257456') // true
  *
  * // 一次性短期
- * isTWCard('F290299977') // true
+ * isTWCard('F290299977') // false
+ * isTWCard('F290299977', { loose: true }) // true
  */
 
 function isTWCard(value) {
-  var valueStr = (0, _convertToString["default"])(value);
-  return regTWCard.test(valueStr);
+  var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+      _ref$loose = _ref.loose,
+      loose = _ref$loose === void 0 ? false : _ref$loose;
+
+  var valueStr = (0, _normalizeString["default"])(value);
+
+  if (regTWCard.test(valueStr)) {
+    return true;
+  }
+
+  return loose ? singleRegTWCard.test(valueStr) : false;
 }
 
 var _default = isTWCard;

package/lib/isTelephone.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -36,7 +36,7 @@ var reg = /^(0\d{2,3}\-)?([2-9]\d{6,7})(\-\d{1,6})?$/;
  */
 
 function isTelephone(value) {
-  var valueStr = (0, _convertToString["default"])(value);
+  var valueStr = (0, _normalizeString["default"])(value);
   return reg.test(valueStr);
 }
 

package/lib/isUrl.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -45,7 +45,7 @@ var reg = /(((^https?:(?:\/\/)?)(?:[-;:&=\+\$,\w]+@)?[A-Za-z0-9.-]+(?::\d+)?|(?:
  */
 
 function isUrl(value) {
-  var valueStr = (0, _convertToString["default"])(value);
+  var valueStr = (0, _normalizeString["default"])(value);
   return reg.test(valueStr);
 }
 

package/lib/isVehicle.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -40,7 +40,7 @@ var reg = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕
  */
 
 function isVehicle(value) {
-  var valueStr = (0, _convertToString["default"])(value);
+  var valueStr = (0, _normalizeString["default"])(value);
   return reg.test(valueStr);
 }
 

package/lib/isWX.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -30,7 +30,7 @@ var reg = /^[a-z]([-_a-z0-9]{5,19})+$/i;
  */
 
 function isWX(value) {
-  var valueStr = (0, _convertToString["default"])(value);
+  var valueStr = (0, _normalizeString["default"])(value);
   return reg.test(valueStr);
 }
 

package/lib/randomString.js

@@ -34,7 +34,7 @@ function internalRandomString() {
  * @alias module:Other.randomString
  * @since 4.8.0
  * @param {number} [len=0] 长度
- * @param {string} [optionalChars] 允许的字符，默认为数字和大小写字母
+ * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符，默认为数字和大小写字母
  * @returns {string} 随机字符串
  * @example
  * randomString(5); // slk23

package/lib/strlen.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+/**
+ * 获取字符长度。中文汉字占2个字符，英文占1个字符，特殊如emoji占4个字符。
+ *
+ * @static
+ * @alias module:Other.strlen
+ * @since 4.10.0
+ * @param {string} str 字符串
+ * @returns {number} 字符长度
+ * @example
+ *
+ * strlen('你好a'); // 5
+ * strlen('你好，世界！'); // 12
+ * strlen('严両丞丽'); // 8
+ * strlen('abcde'); // 5
+ * strlen('𠮷'); // 4
+ * strlen('🍎'); // 4
+ *
+ */
+function strlen(str) {
+  var realStr = (0, _normalizeString["default"])(str);
+  var len = 0;
+
+  for (var i = 0; i < realStr.length; i++) {
+    var c = realStr.charCodeAt(i);
+
+    if (c >= 0x0001 && c <= 0x007e || 0xff60 <= c && c <= 0xff9f) {
+      len++;
+    } else {
+      len += 2;
+    }
+  }
+
+  return len;
+}
+
+var _default = strlen;
+exports["default"] = _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.9.0",
+  "version": "4.10.2",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/index.d.ts

@@ -41,4 +41,5 @@ export { default as round } from "./round";
 export { default as waitTime } from "./waitTime";
 export { default as calculateCursorPosition } from "./calculateCursorPosition";
 export { default as randomString } from "./randomString";
+export { default as strlen } from "./strlen";
 export { setDisableWarning } from "./utils/config";

package/types/isPassport.d.ts

@@ -1,7 +1,7 @@
 export default isPassport;
 /**
  * 检测值是否为护照号
- * 支持普通护照(E*)、外交护照(DE)、公务护照(SE)、公务普通护照(PE)、香港特区护照(K/KJ)、澳门特区护照(MA)
+ * 支持普通护照(E*)、外交护照(DE)、公务护照(SE)、公务普通护照(PE)、香港特区护照(K/KJ/H*)、澳门特区护照(MA/MB/M*)，注意不区分大小写
  *
  * @static
  * @alias module:Validator.isPassport

package/types/isSwiftCode.d.ts

@@ -8,5 +8,15 @@ export default isSwiftCode;
  * @since 4.9.0
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为 Swift Code
+ * @example
+ *
+ * isSwiftCode('DEUTDEFF') //  true
+ * isSwiftCode('deutdeff') //  false
+ *
+ * isSwiftCode('BKTWTWTP010') //  true
+ * isSwiftCode('010BKTWTWTP') //  false
+ *
+ * isSwiftCode('ICBKCNBJBJM') //  true
+ *
  */
 declare function isSwiftCode(value: any): boolean;

package/types/isTWCard.d.ts

@@ -7,12 +7,17 @@ export default isTWCard;
  * @since 4.0.0
  * @see 参考 {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
  * @param {*} value 要检测的值
+ * @param {Object} [options] 配置项
+ * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证
  * @returns {boolean} 是否为台湾居民来往大陆通行证
  * @example
  * isTWCard('12345678') // true
  * isTWCard('07257456') // true
  *
  * // 一次性短期
- * isTWCard('F290299977') // true
+ * isTWCard('F290299977') // false
+ * isTWCard('F290299977', { loose: true }) // true
  */
-declare function isTWCard(value: any): boolean;
+declare function isTWCard(value: any, { loose }?: {
+    loose?: boolean | undefined;
+} | undefined): boolean;

package/types/randomString.d.ts

@@ -6,7 +6,7 @@ export default randomString;
  * @alias module:Other.randomString
  * @since 4.8.0
  * @param {number} [len=0] 长度
- * @param {string} [optionalChars] 允许的字符，默认为数字和大小写字母
+ * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符，默认为数字和大小写字母
  * @returns {string} 随机字符串
  * @example
  * randomString(5); // slk23

package/types/strlen.d.ts

@@ -0,0 +1,20 @@
+export default strlen;
+/**
+ * 获取字符长度。中文汉字占2个字符，英文占1个字符，特殊如emoji占4个字符。
+ *
+ * @static
+ * @alias module:Other.strlen
+ * @since 4.10.0
+ * @param {string} str 字符串
+ * @returns {number} 字符长度
+ * @example
+ *
+ * strlen('你好a'); // 5
+ * strlen('你好，世界！'); // 12
+ * strlen('严両丞丽'); // 8
+ * strlen('abcde'); // 5
+ * strlen('𠮷'); // 4
+ * strlen('🍎'); // 4
+ *
+ */
+declare function strlen(str: string): number;