util-helpers 4.21.3 → 4.21.5

package/README.md

@@ -44,20 +44,32 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
 > 数学计算，修正了浮点数计算问题，适用于金额计算。参考：[JS 浮点数计算测试](https://2zbuy.csb.app/)
 
 - 数学计算
-  - [plus](https://doly-dev.github.io/util-helpers/module-Math.html#.plus) - 加
-  - [minus](https://doly-dev.github.io/util-helpers/module-Math.html#.minus) - 减
-  - [times](https://doly-dev.github.io/util-helpers/module-Math.html#.times) - 乘
   - [divide](https://doly-dev.github.io/util-helpers/module-Math.html#.divide) - 除
-  - [round](https://doly-dev.github.io/util-helpers/module-Math.html#.round) - 四舍五入
   - [gcd](https://doly-dev.github.io/util-helpers/module-Math.html#.gcd) - 最大公约数
   - [lcm](https://doly-dev.github.io/util-helpers/module-Math.html#.lcm) - 最小公倍数
+  - [minus](https://doly-dev.github.io/util-helpers/module-Math.html#.minus) - 减
+  - [plus](https://doly-dev.github.io/util-helpers/module-Math.html#.plus) - 加
+  - [round](https://doly-dev.github.io/util-helpers/module-Math.html#.round) - 四舍五入
+  - [times](https://doly-dev.github.io/util-helpers/module-Math.html#.times) - 乘
+- 其他
+  - [ajax](https://doly-dev.github.io/util-helpers/module-Other.html#.ajax) - 请求
+  - [calculateCursorPosition](https://doly-dev.github.io/util-helpers/module-Other.html#.calculateCursorPosition) - 计算光标位置
+  - [compressImage](https://doly-dev.github.io/util-helpers/module-Other.html#.compressImage) - 压缩图片
+  - [download](https://doly-dev.github.io/util-helpers/module-Other.html#.download) - 下载
+  - [getFileBlob](https://doly-dev.github.io/util-helpers/module-Other.html#.getFileBlob) - 获取文件 Blob
+  - [getImageInfo](https://doly-dev.github.io/util-helpers/module-Other.html#.getImageInfo) - 获取图片信息
+  - [loadImage](https://doly-dev.github.io/util-helpers/module-Other.html#.loadImage) - 加载图片
+  - [loadImageWithBlob](https://doly-dev.github.io/util-helpers/module-Other.html#.loadImageWithBlob) - 加载图片和 blob 对象
+  - [loadScript](https://doly-dev.github.io/util-helpers/module-Other.html#.loadScript) - 加载 js 文件
+  - [randomString](https://doly-dev.github.io/util-helpers/module-Other.html#.randomString) - 随机字符串
+  - [strlen](https://doly-dev.github.io/util-helpers/module-Other.html#.strlen) - 字符长度
 - 数据处理
   - [bytesToSize](https://doly-dev.github.io/util-helpers/module-Processor.html#.bytesToSize) - 字节转换为存储单位
   - [dataURLToBlob](https://doly-dev.github.io/util-helpers/module-Processor.html#.dataURLToBlob) - 将 DataURL 转为 Blob 对象
   - [fileReader](https://doly-dev.github.io/util-helpers/module-Processor.html#.fileReader) - 读取 Blob 或 File 对象，转为 Base64/String/ArrayBuffer
-  - [formatMoney](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMoney) - 格式化金额
-  - [formatMobile](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile) - 格式化手机号码
   - [formatBankCard](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard) - 格式化银行卡
+  - [formatMobile](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile) - 格式化手机号码
+  - [formatMoney](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMoney) - 格式化金额
   - [numberToChinese](https://doly-dev.github.io/util-helpers/module-Processor.html#.numberToChinese) - 数字转中文数字
   - [padZero](https://doly-dev.github.io/util-helpers/module-Processor.html#.padZero) - 前置补零
   - [parseIdCard](https://doly-dev.github.io/util-helpers/module-Processor.html#.parseIdCard) - 解析身份证号码
@@ -65,48 +77,36 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
   - [safeDate](https://doly-dev.github.io/util-helpers/module-Processor.html#.safeDate) - 创建一个 Date 实例，同 new Date
   - [setDataURLPrefix](https://doly-dev.github.io/util-helpers/module-Processor.html#.setDataURLPrefix) - 设置 DataURL 前缀、MIME 类型、base64 标识
 - 树结构数据操作
+  - [filterTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.filterTree) - 过滤树节点
   - [findTreeNode](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNode) - 查找树结构数据节点
   - [findTreeNodes](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNodes) - 查找树结构数据多个节点
   - [findTreeSelect](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeSelect) - 查找包含当前节点的所有父级节点
-  - [filterTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.filterTree) - 过滤树节点
   - [listToTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.listToTree) - 列表数据转树结构
   - [transformFieldNames](https://doly-dev.github.io/util-helpers/module-Processor.html#.transformFieldNames) - 转换字段名
   - [treeToList](https://doly-dev.github.io/util-helpers/module-Processor.html#.treeToList) - 树结构转列表数据
 - 数据验证
-  - [isMobile](https://doly-dev.github.io/util-helpers/module-Validator.html#.isMobile) - 手机号码
-  - [isTelephone](https://doly-dev.github.io/util-helpers/module-Validator.html#.isTelephone) - 固定电话
-  - [isPostcode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPostcode) - 邮政编码
+  - [isBankCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isBankCard) - 银行卡
+  - [isBusinessLicense](https://doly-dev.github.io/util-helpers/module-Validator.html#.isBusinessLicense) - 营业执照，也叫工商注册号
+  - [isChinese](https://doly-dev.github.io/util-helpers/module-Validator.html#.isChinese) - 中文
+  - [isEmail](https://doly-dev.github.io/util-helpers/module-Validator.html#.isEmail) - 邮箱
   - [isHMCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isHMCard) - 港澳居民来往内地通行证，俗称回乡证或回乡卡
-  - [isTWCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isTWCard) - 台湾居民来往大陆通行证，俗称台胞证
+  - [isIPv4](https://doly-dev.github.io/util-helpers/module-Validator.html#.isIPv4) - IPv4
+  - [isIPv6](https://doly-dev.github.io/util-helpers/module-Validator.html#.isIPv6) - IPv6
   - [isIdCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isIdCard) - 身份证号
-  - [isEmail](https://doly-dev.github.io/util-helpers/module-Validator.html#.isEmail) - 邮箱
+  - [isMobile](https://doly-dev.github.io/util-helpers/module-Validator.html#.isMobile) - 手机号码
+  - [isPassport](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassport) - 护照号
+  - [isPassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassword) 密码强度
+  - [isPostcode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPostcode) - 邮政编码
   - [isQQ](https://doly-dev.github.io/util-helpers/module-Validator.html#.isQQ) - QQ 号
-  - [isWX](https://doly-dev.github.io/util-helpers/module-Validator.html#.isWX) - 微信号
-  - [isVehicle](https://doly-dev.github.io/util-helpers/module-Validator.html#.isVehicle) - 车牌号
-  - [isBankCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isBankCard) - 银行卡
   - [isSocialCreditCode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isSocialCreditCode) - 统一社会信用代码，也叫三证合一组织代码
   - [isSwiftCode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isSwiftCode) - Swift Code
-  - [isPassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassword) 密码强度
-  - [isPassport](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassport) - 护照号
-  - [isChinese](https://doly-dev.github.io/util-helpers/module-Validator.html#.isChinese) - 中文
-  - [isIPv4](https://doly-dev.github.io/util-helpers/module-Validator.html#.isIPv4) - IPv4
-  - [isIPv6](https://doly-dev.github.io/util-helpers/module-Validator.html#.isIPv6) - IPv6
+  - [isTWCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isTWCard) - 台湾居民来往大陆通行证，俗称台胞证
+  - [isTelephone](https://doly-dev.github.io/util-helpers/module-Validator.html#.isTelephone) - 固定电话
   - [isUrl](https://doly-dev.github.io/util-helpers/module-Validator.html#.isUrl) - URL
   - [isValidNumber](https://doly-dev.github.io/util-helpers/module-Validator.html#.isValidNumber) - 有效数字
-  - [isBusinessLicense](https://doly-dev.github.io/util-helpers/module-Validator.html#.isBusinessLicense) - 营业执照，也叫工商注册号
+  - [isVehicle](https://doly-dev.github.io/util-helpers/module-Validator.html#.isVehicle) - 车牌号
+  - [isWX](https://doly-dev.github.io/util-helpers/module-Validator.html#.isWX) - 微信号
   - [validatePassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.validatePassword) - 验证密码
-- 其他
-  - [ajax](https://doly-dev.github.io/util-helpers/module-Other.html#.ajax) - 请求
-  - [calculateCursorPosition](https://doly-dev.github.io/util-helpers/module-Other.html#.calculateCursorPosition) - 计算光标位置
-  - [compressImage](https://doly-dev.github.io/util-helpers/module-Other.html#.compressImage) - 压缩图片
-  - [download](https://doly-dev.github.io/util-helpers/module-Other.html#.download) - 下载
-  - [getFileBlob](https://doly-dev.github.io/util-helpers/module-Other.html#.getFileBlob) - 获取文件 Blob
-  - [getImageInfo](https://doly-dev.github.io/util-helpers/module-Other.html#.getImageInfo) - 获取图片信息
-  - [loadImage](https://doly-dev.github.io/util-helpers/module-Other.html#.loadImage) - 加载图片
-  - [loadImageWithBlob](https://doly-dev.github.io/util-helpers/module-Other.html#.loadImageWithBlob) - 加载图片和 blob 对象
-  - [loadScript](https://doly-dev.github.io/util-helpers/module-Other.html#.loadScript) - 加载 js 文件
-  - [randomString](https://doly-dev.github.io/util-helpers/module-Other.html#.randomString) - 随机字符串
-  - [strlen](https://doly-dev.github.io/util-helpers/module-Other.html#.strlen) - 字符长度
 
 ## 精选第三方工具库
 

package/dist/util-helpers.js

@@ -475,19 +475,30 @@
         return reg$4.test(valueStr);
     }
 
+    var URLExisted = typeof URL !== 'undefined';
+
+    var objectKeys = Object.keys;
+    var objectValues = Object.values;
+    var createObjectURL = URLExisted ? URL.createObjectURL : constant('');
+    var revokeObjectURL = URLExisted ? URL.revokeObjectURL : noop;
+
     var chineseDictionary = {
         chineseBasic: '[\u4e00-\u9fa5]',
-        chineseExtend: '[\u9ea6-\u9fef]',
-        chineseExtendA: '[\u3400-\u4DB5]',
-        chineseExtendB: "[\uD840\uDC00-\uD869\uDED6]",
-        chineseExtendC: "[\uD869\uDF00-\uD86D\uDF34]",
+        chineseExtend: '[\u9ea6-\u9fff]',
+        chineseExtend2: '[\uF900-\uFAD9]',
+        chineseExtendA: '[\u3400-\u4DBF]',
+        chineseExtendB: "[\uD840\uDC00-\uD869\uDEDF]",
+        chineseExtendC: "[\uD869\uDF00-\uD86D\uDF38]",
         chineseExtendD: "[\uD86D\uDF40-\uD86E\uDC1D]",
         chineseExtendE: "[\uD86E\uDC20-\uD873\uDEA1]",
-        chineseExtendF: "[\uD873\uDEB0-\uD87A\uDFE0]"
+        chineseExtendF: "[\uD873\uDEB0-\uD87A\uDFE0]",
+        chineseExtendG: "[\uD880\uDC00-\uD884\uDF4A]",
+        chineseExtendH: "[\uD884\uDF50-\uD888\uDFAF]",
+        chineseExtendI: "[\uD87A\uDFF0-\uD87B\uDE5D]"
     };
     var looseChineseRegExp = chineseDictionary.chineseBasic + '+';
     var chineseRegExp = '^' + chineseDictionary.chineseBasic + '+$';
-    var chineseWithExtend = '(?:' + chineseDictionary.chineseBasic + '|' + chineseDictionary.chineseExtend + '|' + chineseDictionary.chineseExtendA + '|' + chineseDictionary.chineseExtendB + '|' + chineseDictionary.chineseExtendC + '|' + chineseDictionary.chineseExtendD + '|' + chineseDictionary.chineseExtendE + '|' + chineseDictionary.chineseExtendF + ')';
+    var chineseWithExtend = '(?:' + objectValues(chineseDictionary).join('|') + ')';
     var looseChineseExtendRegExp = chineseWithExtend + '+';
     var chineseExtendRegExp = '^' + chineseWithExtend + '+$';
     var supportRegExpUnicode = RegExp.prototype.hasOwnProperty('unicode');
@@ -1141,7 +1152,7 @@
         dataURL: 'readAsDataURL',
         text: 'readAsText'
     };
-    function fileReader(blob, type) {
+    var fileReader = function (blob, type) {
         if (type === void 0) { type = 'dataURL'; }
         var method = FileReaderMethodMap[type];
         if (!method) {
@@ -1153,7 +1164,7 @@
             reader.onload = function () { return resolve(reader.result); };
             reader.onerror = function (error) { return reject(error); };
         });
-    }
+    };
 
     function blobToDataURL(blob) {
         return fileReader(blob);
@@ -1183,7 +1194,7 @@
         return toString(value);
     }
 
-    function safeDate(value) {
+    var safeDate = function (value) {
         var args = [];
         for (var _i = 1; _i < arguments.length; _i++) {
             args[_i - 1] = arguments[_i];
@@ -1193,7 +1204,7 @@
             return new (Date.bind.apply(Date, __spreadArray([void 0, safeValue], __read(args), false)))();
         }
         return typeof safeValue === 'undefined' ? new Date() : new Date(safeValue);
-    }
+    };
 
     function formatMobile(mobileNo, options) {
         if (mobileNo === void 0) { mobileNo = ''; }
@@ -1368,12 +1379,6 @@
         return divide(product, gcd.apply(void 0, __spreadArray([], __read(args), false)));
     }
 
-    var URLExisted = typeof URL !== 'undefined';
-
-    var objectKeys = Object.keys;
-    var createObjectURL = URLExisted ? URL.createObjectURL : constant('');
-    var revokeObjectURL = URLExisted ? URL.revokeObjectURL : noop;
-
     function ajax(url, options) {
         var _a = options || {}, _b = _a.method, method = _b === void 0 ? 'get' : _b, _c = _a.data, data = _c === void 0 ? null : _c, timeout = _a.timeout, headers = _a.headers, _d = _a.withCredentials, withCredentials = _d === void 0 ? false : _d, _e = _a.async, async = _e === void 0 ? true : _e, _f = _a.user, user = _f === void 0 ? null : _f, _g = _a.password, password = _g === void 0 ? null : _g, responseType = _a.responseType, onReadyStateChange = _a.onReadyStateChange, onLoadStart = _a.onLoadStart, onProgress = _a.onProgress, onAbort = _a.onAbort, onTimeout = _a.onTimeout, onError = _a.onError, onLoad = _a.onLoad, onLoadEnd = _a.onLoadEnd;
         return new Promise(function (resolve, reject) {
@@ -1485,72 +1490,98 @@
 
     var EmitterPro = /** @class */ (function () {
         function EmitterPro() {
-            this.handler = {};
+            this.handlers = {};
         }
         EmitterPro.prototype.eventNames = function () {
-            return Object.keys(this.handler);
+            var _a;
+            var symbols = ((_a = Object.getOwnPropertySymbols) === null || _a === void 0 ? void 0 : _a.call(Object, this.handlers)) || [];
+            var keys = Object.keys(this.handlers);
+            return keys.concat(symbols);
+        };
+        EmitterPro.prototype.rawListeners = function (eventName) {
+            var handler = this.handlers[eventName];
+            return handler ? handler.map(function (item) { return item.raw; }) : [];
         };
         EmitterPro.prototype.listeners = function (eventName) {
-            return this.handler[eventName] || [];
+            var handler = this.handlers[eventName];
+            return handler ? handler.map(function (item) { return item.wrap; }) : [];
         };
         EmitterPro.prototype.hasListener = function (eventName, listener) {
-            return this.listeners(eventName).some(function (item) { return item === listener; });
+            return this.rawListeners(eventName).some(function (item) { return item === listener; });
         };
-        EmitterPro.prototype.on = function (eventName, listener) {
-            if (!this.handler[eventName]) {
-                this.handler[eventName] = [listener];
+        EmitterPro.prototype._on = function (eventName, raw, wrap, context, dir) {
+            if (context === void 0) { context = null; }
+            if (dir === void 0) { dir = 1; }
+            var currentListener = { raw: raw, wrap: wrap, context: context };
+            if (!this.handlers[eventName]) {
+                this.handlers[eventName] = [currentListener];
             }
             else {
-                // 不允许添加相同的方法
-                if (!this.hasListener(eventName, listener)) {
-                    this.handler[eventName].push(listener);
-                }
+                var appendMethod = dir === 1 ? 'push' : 'unshift';
+                this.handlers[eventName][appendMethod](currentListener);
             }
             return this;
         };
+        EmitterPro.prototype.prependListener = function (eventName, listener, context) {
+            return this._on(eventName, listener, listener, context, 0);
+        };
+        EmitterPro.prototype.on = function (eventName, listener, context) {
+            return this._on(eventName, listener, listener, context);
+        };
+        EmitterPro.prototype._wrapOnce = function (eventName, listener, context) {
+            var _this = this;
+            if (context === void 0) { context = null; }
+            var wrap = (function () {
+                var args = [];
+                for (var _i = 0; _i < arguments.length; _i++) {
+                    args[_i] = arguments[_i];
+                }
+                listener.apply(context, args);
+                _this.off(eventName, wrap);
+            });
+            return wrap;
+        };
+        EmitterPro.prototype.once = function (eventName, listener, context) {
+            var wrap = this._wrapOnce(eventName, listener, context);
+            return this._on(eventName, listener, wrap, context);
+        };
+        EmitterPro.prototype.prependOnceListener = function (eventName, listener, context) {
+            var wrap = this._wrapOnce(eventName, listener, context);
+            return this._on(eventName, listener, wrap, context, 0);
+        };
         EmitterPro.prototype.off = function (eventName, listener) {
-            if (this.handler[eventName]) {
-                if (typeof listener === 'function') {
-                    this.handler[eventName] = this.handler[eventName].filter(function (item) { return item !== listener; });
+            var handler = this.handlers[eventName];
+            if (handler) {
+                if (listener) {
+                    var index = handler.findIndex(function (item) { return item.wrap === listener || item.raw === listener; });
+                    if (index !== -1) {
+                        handler.splice(index, 1);
+                    }
                 }
                 else {
-                    delete this.handler[eventName];
+                    delete this.handlers[eventName];
                 }
             }
             return this;
         };
+        EmitterPro.prototype.offAll = function () {
+            this.handlers = {};
+            return this;
+        };
         EmitterPro.prototype.emit = function (eventName) {
             var args = [];
             for (var _i = 1; _i < arguments.length; _i++) {
                 args[_i - 1] = arguments[_i];
             }
-            var listeners = this.listeners(eventName);
-            if (listeners.length > 0) {
-                listeners.forEach(function (listener) {
-                    // eslint-disable-next-line prefer-spread
-                    listener.apply(void 0, args);
+            var handler = this.handlers[eventName];
+            if (handler && handler.length > 0) {
+                handler.forEach(function (listener) {
+                    listener.wrap.apply(listener.context, args);
                 });
                 return true;
             }
             return false;
         };
-        EmitterPro.prototype.once = function (eventName, listener) {
-            var _this = this;
-            var wrap = function () {
-                var args = [];
-                for (var _i = 0; _i < arguments.length; _i++) {
-                    args[_i] = arguments[_i];
-                }
-                // eslint-disable-next-line prefer-spread
-                listener.apply(void 0, args);
-                _this.off(eventName, wrap);
-            };
-            return this.on(eventName, wrap);
-        };
-        EmitterPro.prototype.offAll = function () {
-            this.handler = {};
-            return this;
-        };
         return EmitterPro;
     }());
 
@@ -1649,7 +1680,7 @@
             }, type, quality);
         });
     }
-    function compressImage(img, options) {
+    var compressImage = function (img, options) {
         if (options === void 0) { options = {}; }
         return new Promise(function (resolve, reject) {
             var width = options.width, height = options.height, rotate = options.rotate, _a = options.offset, offset = _a === void 0 ? [0, 0] : _a, _b = options.cacheImage, cacheImage = _b === void 0 ? true : _b, _c = options.background, background = _c === void 0 ? '#fff' : _c, canvasWidth = options.canvasWidth, canvasHeight = options.canvasHeight, _d = options.format, format = _d === void 0 ? 'blob' : _d, _e = options.type, type = _e === void 0 ? 'image/jpeg' : _e, _f = options.quality, quality = _f === void 0 ? 0.8 : _f, beforeCompress = options.beforeCompress, beforeDraw = options.beforeDraw, afterDraw = options.afterDraw, ajaxOptions = options.ajaxOptions;
@@ -1706,7 +1737,7 @@
             })
                 .catch(reject);
         });
-    }
+    };
 
     function saver(blobUrl, fileName) {
         if (fileName === void 0) { fileName = ''; }
@@ -2226,9 +2257,9 @@
         return internalFindTreeSelect(tree, predicate, childrenField);
     }
 
-    var VERSION = "4.21.3";
+    var VERSION = "4.21.5";
 
-    var version = "4.21.3";
+    var version = "4.21.5";
 
     exports.VERSION = VERSION;
     exports.ajax = ajax;