util-helpers 4.21.4 → 4.21.6

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

@@ -477,6 +477,7 @@
 
     var URLExisted = typeof URL !== 'undefined';
 
+    var nativeUndefined = void 0;
     var objectKeys = Object.keys;
     var objectValues = Object.values;
     var createObjectURL = URLExisted ? URL.createObjectURL : constant('');
@@ -510,7 +511,7 @@
         var extendRegExp = loose ? looseChineseExtendRegExp : chineseExtendRegExp;
         var hasExtend = useExtend && supportRegExpUnicode;
         var resultRegExp = hasExtend ? extendRegExp : basicRegExp;
-        var flag = hasExtend ? 'u' : undefined;
+        var flag = hasExtend ? 'u' : nativeUndefined;
         var reg = new RegExp(resultRegExp, flag);
         return reg.test(valueStr);
     }
@@ -1152,7 +1153,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) {
@@ -1164,7 +1165,7 @@
             reader.onload = function () { return resolve(reader.result); };
             reader.onerror = function (error) { return reject(error); };
         });
-    }
+    };
 
     function blobToDataURL(blob) {
         return fileReader(blob);
@@ -1194,7 +1195,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];
@@ -1204,7 +1205,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 = ''; }
@@ -1490,72 +1491,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;
     }());
 
@@ -1654,7 +1681,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;
@@ -1687,7 +1714,7 @@
                     ctx.fillRect(0, 0, canvas.width, canvas.height);
                 }
                 var internalOffset = [0, 0];
-                if (rotate !== undefined) {
+                if (rotate !== nativeUndefined) {
                     ctx.translate(image.width / 2, image.height / 2);
                     internalOffset = [-image.width / 2, -image.height / 2];
                     ctx.rotate((rotate * Math.PI) / 180);
@@ -1711,7 +1738,7 @@
             })
                 .catch(reject);
         });
-    }
+    };
 
     function saver(blobUrl, fileName) {
         if (fileName === void 0) { fileName = ''; }
@@ -1767,7 +1794,7 @@
                     case 5:
                         res = _a.sent();
                         currentFileName = fileName || data.split('?')[0].split('#')[0].split('/').pop();
-                        return [2, download(res, { fileName: currentFileName, type: type || (isBlob(res) ? res.type : undefined) })];
+                        return [2, download(res, { fileName: currentFileName, type: type || (isBlob(res) ? res.type : nativeUndefined) })];
                     case 6:
                         payload = new Blob([data], { type: type || 'text/plain' });
                         _a.label = 7;
@@ -2231,9 +2258,9 @@
         return internalFindTreeSelect(tree, predicate, childrenField);
     }
 
-    var VERSION = "4.21.4";
+    var VERSION = "4.21.6";
 
-    var version = "4.21.4";
+    var version = "4.21.6";
 
     exports.VERSION = VERSION;
     exports.ajax = ajax;