util-helpers 4.19.3 → 4.20.0

package/README.md

@@ -1,10 +1,8 @@
 # util-helpers
 
-[![npm][npm]][npm-url] [![Build and Deploy Docs](https://github.com/doly-dev/util-helpers/actions/workflows/ci.yml/badge.svg)](https://github.com/doly-dev/util-helpers/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/doly-dev/util-helpers/branch/master/graph/badge.svg?token=nhm6Zrmmyq)](https://codecov.io/gh/doly-dev/util-helpers) ![npm](https://img.shields.io/npm/dt/util-helpers) ![GitHub](https://img.shields.io/github/license/doly-dev/util-helpers.svg)
-
-[util-helpers](https://doly-dev.github.io/util-helpers/index.html) 是一个基于业务场景的工具方法库。
+一个基于业务场景的工具方法库。[点击查看在线文档](https://doly-dev.github.io/util-helpers/index.html)。
 
-[点击查看在线文档](https://doly-dev.github.io/util-helpers/index.html)。
+[![npm][npm]][npm-url] [![Build and Deploy Docs](https://github.com/doly-dev/util-helpers/actions/workflows/ci.yml/badge.svg)](https://github.com/doly-dev/util-helpers/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/doly-dev/util-helpers/branch/master/graph/badge.svg?token=nhm6Zrmmyq)](https://codecov.io/gh/doly-dev/util-helpers) ![npm](https://img.shields.io/npm/dt/util-helpers) ![GitHub](https://img.shields.io/github/license/doly-dev/util-helpers.svg)
 
 ## 使用
 
@@ -49,6 +47,8 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
   - [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) - 最小公倍数
 - 数据处理
   - [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 对象
@@ -96,7 +96,11 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
 - 其他
   - [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) - 下载
+  - [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

@@ -17,6 +17,10 @@
     var hasOwnProperty = objectProto.hasOwnProperty;
     var functionToString = Function.prototype.toString;
     functionToString.call(Object);
+    var symbolProto = Symbol ? Symbol.prototype : undefined;
+    symbolProto ? symbolProto.valueOf : undefined;
+    symbolProto ? symbolProto.toString : undefined;
+    var symToStringTag = Symbol ? Symbol.toStringTag : undefined;
     var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
     var MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER || -9007199254740991;
     var blobExisted = typeof Blob !== 'undefined';
@@ -35,6 +39,17 @@
         }
         return '';
     }
+    function wrapTags(tags) {
+        return tags.map(function (item) { return '[object ' + item + ']'; });
+    }
+    var numberTag = '[object Number]';
+    var stringTag = '[object String]';
+    var symbolTag = '[object Symbol]';
+    var argumentsTag = '[object Arguments]';
+    wrapTags(['Float32Array', 'Float64Array', 'Int8Array', 'Int16Array', 'Int32Array', 'Uint8Array', 'Uint8ClampedArray', 'Uint16Array', 'Uint32Array', 'BigInt64Array', 'BigUint64Array']);
+    wrapTags(['Function', 'AsyncFunction', 'GeneratorFunction', 'Proxy']);
+    var blobTag = '[object Blob]';
+    var fileTag = '[object Blob]';
     var objectTag = '[object Object]';
     var dataViewTag = '[object DataView]';
     var mapTag = '[object Map]';
@@ -59,11 +74,11 @@
     }
 
     function getRawTag(value) {
-        var isOwn = hasOwnProperty.call(value, Symbol.toStringTag);
-        var tag = value[Symbol.toStringTag];
+        var isOwn = hasOwnProperty.call(value, symToStringTag);
+        var tag = value[symToStringTag];
         var unmasked = false;
         try {
-            value[Symbol.toStringTag] = undefined;
+            value[symToStringTag] = undefined;
             unmasked = true;
         }
         catch (e) {
@@ -71,18 +86,16 @@
         var result = objectToString.call(value);
         if (unmasked) {
             if (isOwn) {
-                value[Symbol.toStringTag] = tag;
+                value[symToStringTag] = tag;
             }
             else {
-                delete value[Symbol.toStringTag];
+                delete value[symToStringTag];
             }
         }
         return result;
     }
     function _getTag(value) {
-        return Symbol && Symbol.toStringTag && Symbol.toStringTag in Object(value)
-            ? getRawTag(value)
-            : objectToString.call(value);
+        return symToStringTag && symToStringTag in Object(value) ? getRawTag(value) : objectToString.call(value);
     }
     var getTag = _getTag;
     if ((dataViewExisted && objectToString.call(new DataView(new ArrayBuffer(1))) !== dataViewTag) ||
@@ -113,20 +126,16 @@
     }
     var getTag$1 = getTag;
 
-    function isType(value, type) {
-        var nativeTypeString = getTag$1(value);
-        if (typeof type === 'string') {
-            return nativeTypeString === '[object ' + type + ']';
-        }
-        return type.some(function (item) { return nativeTypeString === '[object ' + item + ']'; });
+    function checkType(value, tag) {
+        return getTag$1(value) === tag;
     }
-
-    function isObjectLike(value) {
-        return value != null && typeof value === 'object';
+    function checkTypes(value, tags) {
+        var tag = getTag$1(value);
+        return tags.some(function (item) { return tag === item; });
     }
 
     function isSymbol(value) {
-        return typeof value === 'symbol' || (isObjectLike(value) && isType(value, 'Symbol'));
+        return typeof value === 'symbol' || checkType(value, symbolTag);
     }
 
     var reIsBinary = /^0b[01]+$/i;
@@ -163,14 +172,9 @@
         return remainder ? result - remainder : result;
     }
 
-    var argType = 'Arguments';
-    isType((function () { return arguments; })(), argType);
+    checkType((function () { return arguments; })(), argumentsTag);
     var numberIsFinite = Number.isFinite;
 
-    function isFinite$1(value) {
-        return numberIsFinite ? numberIsFinite(value) : typeof value === 'number' && root.isFinite(value);
-    }
-
     function baseToString(value) {
         if (typeof value === 'string') {
             return value;
@@ -188,30 +192,16 @@
         return value == null ? '' : baseToString(value);
     }
 
-    function decimalAdjust(type, value, precision) {
-        if (precision === void 0) { precision = 0; }
-        var func = Math[type];
-        value = toNumber(value);
-        precision = Math.min(toInteger(precision), 292);
-        if (precision === 0 || !isFinite$1(value)) {
-            return func(value);
-        }
-        var pair = toString(value).split('e');
-        value = func(+(pair[0] + 'e' + (pair[1] ? +pair[1] + precision : precision)));
-        pair = toString(value).split('e');
-        return +(pair[0] + 'e' + (pair[1] ? +pair[1] - precision : -precision));
-    }
-
-    function round(number, precision) {
-        return decimalAdjust('round', number, precision);
+    function isBlob(value) {
+        return (blobExisted && value instanceof Blob) || checkTypes(value, [blobTag, fileTag]);
     }
 
-    function isBlob(value) {
-        return (blobExisted && value instanceof Blob) || isType(value, ['Blob', 'File']);
+    function isFinite$1(value) {
+        return numberIsFinite ? numberIsFinite(value) : typeof value === 'number' && root.isFinite(value);
     }
 
     function isNumber(value) {
-        return typeof value === 'number' || (isObjectLike(value) && isType(value, 'Number'));
+        return typeof value === 'number' || checkType(value, numberTag);
     }
 
     function isNaN$1(value) {
@@ -223,7 +213,25 @@
     }
 
     function isString(value) {
-        return typeof value === 'string' || (isObjectLike(value) && isType(value, 'String'));
+        return typeof value === 'string' || checkType(value, stringTag);
+    }
+
+    function decimalAdjust(type, value, precision) {
+        if (precision === void 0) { precision = 0; }
+        var func = Math[type];
+        value = toNumber(value);
+        precision = Math.min(toInteger(precision), 292);
+        if (precision === 0 || !isFinite$1(value)) {
+            return func(value);
+        }
+        var pair = toString(value).split('e');
+        value = func(+(pair[0] + 'e' + (pair[1] ? +pair[1] + precision : precision)));
+        pair = toString(value).split('e');
+        return +(pair[0] + 'e' + (pair[1] ? +pair[1] - precision : -precision));
+    }
+
+    function round(number, precision) {
+        return decimalAdjust('round', number, precision);
     }
 
     function sleep(ms) {
@@ -893,6 +901,7 @@
         return decimal + ret;
     }
     var formatMoney = function (num, options) {
+        if (num === void 0) { num = ''; }
         if (options === void 0) { options = {}; }
         var _a = options.precision, precision = _a === void 0 ? 2 : _a, symbol = options.symbol, _b = options.thousand, thousand = _b === void 0 ? ',' : _b, _c = options.decimal, decimal = _c === void 0 ? '.' : _c;
         if (!checkNumber(num)) {
@@ -928,6 +937,7 @@
     }
 
     function replaceChar(str, options) {
+        if (str === void 0) { str = ''; }
         if (options === void 0) { options = {}; }
         var _a = options.char, char = _a === void 0 ? '*' : _a, exclude = options.exclude;
         var _b = options.start, start = _b === void 0 ? 3 : _b, _c = options.end, end = _c === void 0 ? -4 : _c, repeat = options.repeat;
@@ -1323,6 +1333,58 @@
         return round(num, precision);
     }
 
+    function gcd() {
+        var nums = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            nums[_i] = arguments[_i];
+        }
+        var num1 = nums[0];
+        var num2 = nums[1] === void 0 ? 0 : nums[1];
+        var rest = nums.slice(2);
+        if (rest.length > 0) {
+            return gcd.apply(void 0, [gcd(num1, num2)].concat(rest));
+        }
+        num1 = Math.abs(round(num1));
+        num2 = Math.abs(round(num2));
+        if (isNaN$1(num1) || isNaN$1(num2)) {
+            return Number.NaN;
+        }
+        if (num1 === 0 && num2 === 0) {
+            return 0;
+        }
+        if (num1 === 0) {
+            return num2;
+        }
+        if (num2 === 0) {
+            return num1;
+        }
+        var temp = num2;
+        if (num1 < num2) {
+            temp = num1;
+            num1 = num2;
+            num2 = temp;
+        }
+        while (temp) {
+            temp = num1 % num2;
+            num1 = num2;
+            num2 = temp;
+        }
+        return toNumber(num1);
+    }
+
+    function lcm() {
+        var nums = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            nums[_i] = arguments[_i];
+        }
+        var args = nums.map(function (item) { return Math.abs(round(item)); });
+        if (args.length === 1) {
+            args = args.concat([1]);
+        }
+        var product = args.indexOf(0) > -1 ? 0 : times.apply(void 0, __spreadArray([], __read(args), false));
+        return divide(product, gcd.apply(void 0, __spreadArray([], __read(args), false)));
+    }
+
     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) {
@@ -1405,6 +1467,117 @@
         return pos;
     }
 
+    var SuccessResponseStatus = [200, 304];
+    function getBlob(img) {
+        return new Promise(function (resolve, reject) {
+            if (isBlob(img)) {
+                resolve(img);
+            }
+            else {
+                ajax(img, { responseType: 'blob' })
+                    .then(function (ev) {
+                    var responseStatus = ev.target.status;
+                    if (SuccessResponseStatus.indexOf(responseStatus) !== -1) {
+                        resolve(ev.target.response);
+                    }
+                    else {
+                        reject(new Error("[loadImageWithBlob] The image does not support get requests, responseStatus ".concat(responseStatus, ", '").concat(img, "'.")));
+                    }
+                })
+                    .catch(reject);
+            }
+        });
+    }
+    var cacheImage$2;
+    var cacheResult$2;
+    function loadImageWithBlob(img, useCache) {
+        if (useCache === void 0) { useCache = true; }
+        return new Promise(function (resolve, reject) {
+            if (useCache && cacheImage$2 === img && cacheResult$2) {
+                resolve(cacheResult$2);
+            }
+            else {
+                getBlob(img)
+                    .then(function (blob) {
+                    var url = URL.createObjectURL(blob);
+                    var image = new Image();
+                    image.onload = function () {
+                        URL.revokeObjectURL(url);
+                        var result = { blob: blob, image: image };
+                        if (useCache) {
+                            cacheImage$2 = img;
+                            cacheResult$2 = result;
+                        }
+                        resolve(result);
+                    };
+                    image.onerror = function (err) {
+                        URL.revokeObjectURL(url);
+                        console.error("[loadImageWithBlob] The image load failed, '".concat(img, "'."));
+                        reject(err);
+                    };
+                    image.src = url;
+                })
+                    .catch(reject);
+            }
+        });
+    }
+
+    function canvasToBlob(canvas, type, quality) {
+        return new Promise(function (resolve) {
+            canvas.toBlob(function (blob) {
+                resolve(blob);
+            }, type, quality);
+        });
+    }
+    function compressImage(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;
+            loadImageWithBlob(img, cacheImage)
+                .then(function (_a) {
+                var image = _a.image, blob = _a.blob;
+                var numWidth = toNumber(width);
+                var numHeight = toNumber(height);
+                var numQuality = toNumber(quality);
+                if (numWidth) {
+                    image.width = numWidth;
+                }
+                if (numHeight) {
+                    image.height = numHeight;
+                }
+                beforeCompress === null || beforeCompress === void 0 ? void 0 : beforeCompress({ image: image, blob: blob }, options);
+                var canvas = document.createElement('canvas');
+                var ctx = canvas.getContext('2d');
+                var info = { image: image, blob: blob, canvas: canvas, context: ctx };
+                var numCanvasWidth = toNumber(typeof canvasWidth === 'function' ? canvasWidth(info, options) : canvasWidth);
+                var numCanvasHeight = toNumber(typeof canvasHeight === 'function' ? canvasHeight(info, options) : canvasHeight);
+                canvas.width = numCanvasWidth || image.width;
+                canvas.height = numCanvasHeight || image.height;
+                if (background && background !== 'none') {
+                    ctx.fillStyle = background;
+                    ctx.fillRect(0, 0, canvas.width, canvas.height);
+                }
+                var internalOffset = [0, 0];
+                if (rotate !== undefined) {
+                    ctx.translate(image.width / 2, image.height / 2);
+                    internalOffset = [-image.width / 2, -image.height / 2];
+                    ctx.rotate((rotate * Math.PI) / 180);
+                }
+                var outOffset = typeof offset === 'function' ? offset(info, options) : offset;
+                beforeDraw === null || beforeDraw === void 0 ? void 0 : beforeDraw(info, options);
+                ctx.drawImage(image, internalOffset[0] + toNumber(outOffset[0]), internalOffset[1] + toNumber(outOffset[1]), image.width, image.height);
+                afterDraw === null || afterDraw === void 0 ? void 0 : afterDraw(info, options);
+                if (format === 'blob') {
+                    canvasToBlob(canvas, type, numQuality).then(resolve).catch(reject);
+                }
+                else {
+                    resolve(canvas.toDataURL(type, numQuality));
+                }
+            })
+                .catch(reject);
+        });
+    }
+
     function saver(blobUrl, fileName) {
         if (fileName === void 0) { fileName = ''; }
         var anchor = document.createElement('a');
@@ -1487,6 +1660,81 @@
         });
     }
 
+    function calcContrast(w, h) {
+        var n = gcd(w, h);
+        return "".concat(divide(round(w), n), ":").concat(divide(round(h), n));
+    }
+    var cacheImage$1;
+    var cacheResult$1;
+    function getImageInfo(img, useCache) {
+        if (useCache === void 0) { useCache = true; }
+        return new Promise(function (resolve, reject) {
+            if (useCache && cacheImage$1 === img && cacheResult$1) {
+                resolve(cacheResult$1);
+            }
+            else {
+                loadImageWithBlob(img, false)
+                    .then(function (_a) {
+                    var image = _a.image, blob = _a.blob;
+                    var width = image.width, height = image.height;
+                    var result = {
+                        width: width,
+                        height: height,
+                        contrast: calcContrast(width, height),
+                        measure: "".concat(width, " \u00D7 ").concat(height, " px"),
+                        size: bytesToSize(blob.size),
+                        bytes: blob.size,
+                        image: image,
+                        blob: blob
+                    };
+                    if (useCache) {
+                        cacheImage$1 = img;
+                        cacheResult$1 = result;
+                    }
+                    resolve(result);
+                })
+                    .catch(reject);
+            }
+        });
+    }
+
+    var cacheImage;
+    var cacheResult;
+    function loadImage(img, useCache) {
+        if (useCache === void 0) { useCache = true; }
+        return new Promise(function (resolve, reject) {
+            if (useCache && cacheImage === img && cacheResult) {
+                resolve(cacheResult);
+            }
+            else {
+                var imgIsBlob_1 = isBlob(img);
+                var url_1 = imgIsBlob_1 ? URL.createObjectURL(img) : img;
+                var image_1 = new Image();
+                if (!imgIsBlob_1) {
+                    image_1.crossOrigin = 'anonymous';
+                }
+                image_1.onload = function () {
+                    if (imgIsBlob_1) {
+                        URL.revokeObjectURL(url_1);
+                    }
+                    if (useCache) {
+                        cacheImage = img;
+                        cacheResult = image_1;
+                    }
+                    resolve(image_1);
+                };
+                image_1.onerror = function (err) {
+                    if (imgIsBlob_1) {
+                        URL.revokeObjectURL(url_1);
+                    }
+                    console.error("[loadImage] The image load failed, '".concat(img, "'."));
+                    reject(err);
+                };
+                image_1.src = url_1;
+            }
+        });
+    }
+
     function loadScript(src, options) {
         return new Promise(function (resolve, reject) {
             var head = document.head;
@@ -1820,15 +2068,16 @@
         return internalFindTreeSelect(tree, predicate, childrenField);
     }
 
-    var VERSION = "4.19.3";
+    var VERSION = "4.20.0";
 
-    var version = "4.19.3";
+    var version = "4.20.0";
 
     exports.VERSION = VERSION;
     exports.ajax = ajax;
     exports.blobToDataURL = blobToDataURL;
     exports.bytesToSize = bytesToSize;
     exports.calculateCursorPosition = calculateCursorPosition;
+    exports.compressImage = compressImage;
     exports.dataURLToBlob = dataURLToBlob;
     exports.divide = divide;
     exports.download = download;
@@ -1840,6 +2089,8 @@
     exports.formatBankCard = formatBankCard;
     exports.formatMobile = formatMobile;
     exports.formatMoney = formatMoney;
+    exports.gcd = gcd;
+    exports.getImageInfo = getImageInfo;
     exports.isBankCard = isBankCard;
     exports.isBusinessLicense = isBusinessLicense;
     exports.isChinese = isChinese;
@@ -1862,7 +2113,10 @@
     exports.isValidNumber = isValidNumber;
     exports.isVehicle = isVehicle;
     exports.isWX = isWX;
+    exports.lcm = lcm;
     exports.listToTree = listToTree;
+    exports.loadImage = loadImage;
+    exports.loadImageWithBlob = loadImageWithBlob;
     exports.loadScript = loadScript;
     exports.minus = minus;
     exports.normalizeString = normalizeString;