util-helpers 4.19.4 → 4.20.1

package/README.md

@@ -47,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 对象
@@ -94,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

@@ -8,127 +8,24 @@
         return Array.isArray(value);
     }
 
-    var freeGlobalThis = typeof globalThis === 'object' && globalThis && globalThis.Object === Object && globalThis;
-    var freeGlobal = typeof global === 'object' && global && global.Object === Object && global;
-    var freeSelf = typeof self === 'object' && self && self.Object === Object && self;
-    var root = freeGlobalThis || freeGlobal || freeSelf || Function('return this')() || {};
     var objectProto = Object.prototype;
     var objectToString = objectProto.toString;
-    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 numberIsFinite = Number.isFinite;
     var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
     var MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER || -9007199254740991;
-    var blobExisted = typeof Blob !== 'undefined';
-    function toSource(func) {
-        if (func !== null) {
-            try {
-                return functionToString.call(func);
-            }
-            catch (e) {
-            }
-            try {
-                return func + '';
-            }
-            catch (e) {
-            }
-        }
-        return '';
-    }
-    var objectTag = '[object Object]';
-    var dataViewTag = '[object DataView]';
-    var mapTag = '[object Map]';
-    var promiseTag = '[object Promise]';
-    var setTag = '[object Set]';
-    var weakMapTag = '[object WeakMap]';
-    var dataViewExisted = typeof DataView !== 'undefined';
-    var mapExisted = typeof Map !== 'undefined';
-    var promiseExisted = typeof Promise !== 'undefined';
-    var setExisted = typeof Set !== 'undefined';
-    var weakMapExisted = typeof WeakMap !== 'undefined';
-    var initSource = function (existed, str) { return (existed ? str : ''); };
-    var dataViewCtorString = initSource(dataViewExisted, toSource(DataView));
-    var mapCtorString = initSource(mapExisted, toSource(Map));
-    var promiseCtorString = initSource(promiseExisted, toSource(Promise));
-    var setCtorString = initSource(setExisted, toSource(Set));
-    var weakMapCtorString = initSource(weakMapExisted, toSource(WeakMap));
+    var numberTag = '[object Number]';
+    var stringTag = '[object String]';
+    var symbolTag = '[object Symbol]';
+    var blobTag = '[object Blob]';
 
     function isObject(value) {
         var type = typeof value;
         return value != null && (type === 'object' || type === 'function');
     }
 
-    function getRawTag(value) {
-        var isOwn = hasOwnProperty.call(value, symToStringTag);
-        var tag = value[symToStringTag];
-        var unmasked = false;
-        try {
-            value[symToStringTag] = undefined;
-            unmasked = true;
-        }
-        catch (e) {
-        }
-        var result = objectToString.call(value);
-        if (unmasked) {
-            if (isOwn) {
-                value[symToStringTag] = tag;
-            }
-            else {
-                delete value[symToStringTag];
-            }
-        }
-        return result;
-    }
-    function _getTag(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) ||
-        (mapExisted && objectToString.call(new Map()) !== mapTag) ||
-        (promiseExisted && objectToString.call(Promise.resolve()) !== promiseTag) ||
-        (setExisted && objectToString.call(new Set()) !== setTag) ||
-        (weakMapExisted && objectToString.call(new WeakMap()) !== weakMapTag)) {
-        getTag = function (value) {
-            var result = _getTag(value);
-            var Ctor = result === objectTag ? value.constructor : undefined;
-            var ctorString = Ctor ? toSource(Ctor) : '';
-            if (ctorString) {
-                switch (ctorString) {
-                    case dataViewCtorString:
-                        return dataViewTag;
-                    case mapCtorString:
-                        return mapTag;
-                    case promiseCtorString:
-                        return promiseTag;
-                    case setCtorString:
-                        return setTag;
-                    case weakMapCtorString:
-                        return weakMapTag;
-                }
-            }
-            return result;
-        };
-    }
-    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 isObjectLike(value) {
-        return value != null && typeof value === 'object';
-    }
-
     function isSymbol(value) {
-        return typeof value === 'symbol' || (isObjectLike(value) && isType(value, 'Symbol'));
+        return typeof value === 'symbol' || objectToString.call(value) === symbolTag;
     }
 
     var reIsBinary = /^0b[01]+$/i;
@@ -165,9 +62,7 @@
         return remainder ? result - remainder : result;
     }
 
-    var argType = 'Arguments';
-    isType((function () { return arguments; })(), argType);
-    var numberIsFinite = Number.isFinite;
+    var symbolToString = symbolProto ? symbolProto.toString : undefined;
 
     function baseToString(value) {
         if (typeof value === 'string') {
@@ -177,7 +72,7 @@
             return "".concat(value.map(baseToString));
         }
         if (isSymbol(value)) {
-            return value.toString();
+            return symbolToString ? symbolToString.call(value) : '';
         }
         var result = '' + value;
         return result == '0' && 1 / value === -Infinity ? '-0' : result;
@@ -186,20 +81,30 @@
         return value == null ? '' : baseToString(value);
     }
 
+    var freeGlobalThis = typeof globalThis === 'object' && globalThis && globalThis.Object === Object && globalThis;
+    var freeGlobal = typeof global === 'object' && global && global.Object === Object && global;
+    var freeSelf = typeof self === 'object' && self && self.Object === Object && self;
+    var root = freeGlobalThis || freeGlobal || freeSelf || Function('return this')() || {};
+    var root$1 = root;
+
+    var blobExisted = typeof Blob !== 'undefined';
     function isBlob(value) {
-        return (blobExisted && value instanceof Blob) || isType(value, ['Blob', 'File']);
+        if (blobExisted && value instanceof Blob) {
+            return true;
+        }
+        return objectToString.call(value) === blobTag;
     }
 
     function isFinite$1(value) {
-        return numberIsFinite ? numberIsFinite(value) : typeof value === 'number' && root.isFinite(value);
+        return numberIsFinite ? numberIsFinite(value) : typeof value === 'number' && root$1.isFinite(value);
     }
 
     function isNumber(value) {
-        return typeof value === 'number' || (isObjectLike(value) && isType(value, 'Number'));
+        return typeof value === 'number' || objectToString.call(value) === numberTag;
     }
 
     function isNaN$1(value) {
-        return isNumber(value) && root.isNaN(value);
+        return isNumber(value) && root$1.isNaN(value);
     }
 
     function isPromiseLike$1(value) {
@@ -207,7 +112,7 @@
     }
 
     function isString(value) {
-        return typeof value === 'string' || (isObjectLike(value) && isType(value, 'String'));
+        return typeof value === 'string' || objectToString.call(value) === stringTag;
     }
 
     function decimalAdjust(type, value, precision) {
@@ -1327,6 +1232,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) {
@@ -1409,6 +1366,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');
@@ -1491,6 +1559,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;
@@ -1824,15 +1967,16 @@
         return internalFindTreeSelect(tree, predicate, childrenField);
     }
 
-    var VERSION = "4.19.4";
+    var VERSION = "4.20.1";
 
-    var version = "4.19.4";
+    var version = "4.20.1";
 
     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;
@@ -1844,6 +1988,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;
@@ -1866,7 +2012,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;