ut2 1.5.2 → 1.5.4

package/README.md

@@ -2,7 +2,7 @@
 
 一个现代 JavaScript 实用工具库。[点击查看在线文档]。
 
-[![npm][npm]][npm-url] [![Build and Deploy Docs](https://github.com/caijf/ut2/actions/workflows/ci.yml/badge.svg)](https://github.com/caijf/ut2/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/caijf/ut2/branch/main/graph/badge.svg?token=XKTS0H7085)](https://codecov.io/gh/caijf/ut2) ![npm](https://img.shields.io/npm/dt/ut2) ![GitHub](https://img.shields.io/github/license/caijf/ut2.svg)
+[![npm][npm]][npm-url] [![Build and Deploy Docs](https://github.com/caijf/ut2/actions/workflows/ci.yml/badge.svg)](https://github.com/caijf/ut2/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/caijf/ut2/branch/main/graph/badge.svg?token=XKTS0H7085)](https://codecov.io/gh/caijf/ut2) [![Static Badge](https://img.shields.io/badge/benchmark-online-green)](https://codesandbox.io/s/github/caijf/ut2/tree/main/benchmark) ![npm](https://img.shields.io/npm/dt/ut2) ![GitHub](https://img.shields.io/github/license/caijf/ut2.svg)
 
 ## 比较
 
@@ -16,7 +16,7 @@
 
 兼容现代浏览器 [Firefox](https://www.firefox.com.cn/)、[Chrome](https://www.google.cn/chrome/index.html)、[Safari](https://www.apple.com.cn/safari/)、[Opera](https://www.opera.com/zh-cn)，以及 [Node.js >= 10](https://nodejs.org/) 。
 
-如果要兼容 IE 系列浏览器，建议使用 [@babel/preset-env](https://babeljs.io/docs/babel-preset-env) 设置对应的 `targets` 。
+如果要兼容 IE 系列浏览器，需要提供相应的 Polyfill 支持，建议使用 [@babel/preset-env](https://babeljs.io/docs/babel-preset-env) 设置对应的 `targets` 。
 
 ## 使用
 

package/dist/ut2.js

@@ -15,10 +15,8 @@
     var functionProtoToString = functionProto.toString;
     var symbolExisted = typeof Symbol !== 'undefined';
     var symbolProto = symbolExisted ? Symbol.prototype : undefined;
-    var symbolToStringTag = symbolExisted ? Symbol.toStringTag : undefined;
     var arrayProto = Array.prototype;
     var arrayProtoSlice = arrayProto.slice;
-    var arrayProtoAt = arrayProto.at;
     var mathMin = Math.min;
     var mathMax = Math.max;
     var mathRandom = Math.random;
@@ -62,11 +60,15 @@
 
     function isObject(value) {
         var type = typeof value;
-        return value != null && (type === 'object' || type === 'function');
+        return type === 'function' || (type === 'object' && !!value);
+    }
+
+    function getTag(value) {
+        return objectProtoToString.call(value);
     }
 
     function isSymbol(value) {
-        return typeof value === 'symbol' || objectProtoToString.call(value) === symbolTag;
+        return typeof value === 'symbol' || getTag(value) === symbolTag;
     }
 
     var reIsBinary = /^0b[01]+$/i;
@@ -144,6 +146,10 @@
         return value !== value && other !== other;
     }
 
+    function identity(value) {
+        return value;
+    }
+
     function createIteratee(iteratee) {
         if (typeof iteratee === 'function') {
             return iteratee;
@@ -151,7 +157,7 @@
         if (typeof iteratee === 'string' || typeof iteratee === 'number' || isSymbol(iteratee)) {
             return function (value) { return value[iteratee]; };
         }
-        return function (value) { return value; };
+        return identity;
     }
 
     function difference(array, values, iteratee, strictCheck) {
@@ -201,7 +207,7 @@
         if (typeof value === 'function') {
             return true;
         }
-        var tag = objectProtoToString.call(value);
+        var tag = getTag(value);
         return functionTags.some(function (item) { return item === tag; });
     }
 
@@ -218,11 +224,8 @@
         if (!isArrayLike(array)) {
             return undefined;
         }
-        if (typeof arrayProtoAt === 'function') {
-            return arrayProtoAt.call(array, n);
-        }
-        var index = n < 0 ? n + array.length : n;
-        return array[index];
+        n += n < 0 ? array.length : 0;
+        return array[n];
     }
 
     var MAX_VALUE = 1.7976931348623157e308;
@@ -270,16 +273,27 @@
         return result;
     }
 
+    function isUndefined(value) {
+        return value === void 0;
+    }
+
     function uniq(array, iteratee, strickCheck) {
         if (strickCheck === void 0) { strickCheck = false; }
         if (!isArray(array)) {
             return [];
         }
-        var internalIteratee = createIteratee(iteratee);
-        return array.filter(function (value, index, arr) {
-            var current = internalIteratee(value);
-            return arr.findIndex(function (item) { return eq(internalIteratee(item), current, strickCheck); }) === index;
-        });
+        if (isUndefined(iteratee)) {
+            return array.filter(function (value, index, arr) {
+                return arr.findIndex(function (item) { return eq(item, value, strickCheck); }) === index;
+            });
+        }
+        else {
+            var internalIteratee_1 = createIteratee(iteratee);
+            return array.filter(function (value, index, arr) {
+                var current = internalIteratee_1(value);
+                return arr.findIndex(function (item) { return eq(internalIteratee_1(item), current, strickCheck); }) === index;
+            });
+        }
     }
 
     function union(array, other, iteratee, strickCheck) {
@@ -291,7 +305,7 @@
     }
 
     function isObjectLike(value) {
-        return value != null && typeof value === 'object';
+        return value !== null && typeof value === 'object';
     }
 
     function isArrayLikeObject(value) {
@@ -389,10 +403,6 @@
         return result;
     }
 
-    function identity(value) {
-        return value;
-    }
-
     var symbolToString = symbolProto ? symbolProto.toString : undefined;
     function baseToString(value) {
         if (typeof value === 'string') {
@@ -405,7 +415,7 @@
             return symbolToString ? symbolToString.call(value) : '';
         }
         var result = '' + value;
-        return result == '0' && 1 / value === -Infinity ? '-0' : result;
+        return result === '0' && 1 / value === -Infinity ? '-0' : result;
     }
     function toString(value) {
         return value == null ? '' : baseToString(value);
@@ -485,8 +495,8 @@
         return value == null || value !== value ? defaultValue : value;
     }
 
-    var VERSION = "1.5.2";
-    var supportedArgumentsType = objectProtoToString.call((function () { return arguments; })()) === argumentsTag;
+    var VERSION = "1.5.4";
+    var supportedArgumentsType = getTag((function () { return arguments; })()) === argumentsTag;
     var FUNC_ERROR_TEXT = 'Expected a function';
     function toSource(func) {
         if (func !== null) {
@@ -503,6 +513,7 @@
         }
         return '';
     }
+    var stubFlase = function () { return false; };
 
     function after(n, func) {
         if (typeof func !== 'function') {
@@ -675,7 +686,7 @@
 
     function isArguments(value) {
         if (supportedArgumentsType) {
-            return objectProtoToString.call(value) === argumentsTag;
+            return getTag(value) === argumentsTag;
         }
         return isObjectLike(value) && objectProtoHasOwnProperty.call(value, 'callee') && !objectProtoPropertyIsEnumerable.call(value, 'callee');
     }
@@ -700,7 +711,7 @@
     var nodeIsTypedArray = nodeUtil && nodeUtil.isTypedArray;
 
     function isArrayBuffer(value) {
-        return nodeIsArrayBuffer ? nodeIsArrayBuffer(value) : objectProtoToString.call(value) === arrayBufferTag;
+        return nodeIsArrayBuffer ? nodeIsArrayBuffer(value) : getTag(value) === arrayBufferTag;
     }
 
     var blobExisted = typeof Blob !== 'undefined';
@@ -708,11 +719,11 @@
         if (blobExisted && value instanceof Blob) {
             return true;
         }
-        return objectProtoToString.call(value) === blobTag;
+        return getTag(value) === blobTag;
     }
 
     function isBoolean(value) {
-        return value === true || value === false || objectProtoToString.call(value) === booleanTag;
+        return value === true || value === false || getTag(value) === booleanTag;
     }
 
     function isBuffer(value) {
@@ -725,31 +736,6 @@
         return false;
     }
 
-    function getRawTag(value) {
-        var isOwn = objectProtoHasOwnProperty.call(value, symbolToStringTag);
-        var tag = value[symbolToStringTag];
-        var unmasked = false;
-        try {
-            value[symbolToStringTag] = undefined;
-            unmasked = true;
-        }
-        catch (e) {
-        }
-        var result = objectProtoToString.call(value);
-        if (unmasked) {
-            if (isOwn) {
-                value[symbolToStringTag] = tag;
-            }
-            else {
-                delete value[symbolToStringTag];
-            }
-        }
-        return result;
-    }
-    function getTag(value) {
-        return symbolToStringTag && symbolToStringTag in Object(value) ? getRawTag(value) : objectProtoToString.call(value);
-    }
-
     var dataViewExisted = typeof DataView !== 'undefined';
     var mapExisted = typeof Map !== 'undefined';
     var promiseExisted = typeof Promise !== 'undefined';
@@ -761,11 +747,11 @@
     var setCtorString = toSource(Set);
     var weakMapCtorString = toSource(WeakMap);
     var getTagWithBugfix = getTag;
-    if ((dataViewExisted && objectProtoToString.call(new DataView(new ArrayBuffer(1))) !== dataViewTag) ||
-        (mapExisted && objectProtoToString.call(new Map()) !== mapTag) ||
-        (promiseExisted && objectProtoToString.call(Promise.resolve()) !== promiseTag) ||
-        (setExisted && objectProtoToString.call(new Set()) !== setTag) ||
-        (weakMapExisted && objectProtoToString.call(new WeakMap()) !== weakMapTag)) {
+    if ((dataViewExisted && getTag(new DataView(new ArrayBuffer(1))) !== dataViewTag) ||
+        (mapExisted && getTag(new Map()) !== mapTag) ||
+        (promiseExisted && getTag(Promise.resolve()) !== promiseTag) ||
+        (setExisted && getTag(new Set()) !== setTag) ||
+        (weakMapExisted && getTag(new WeakMap()) !== weakMapTag)) {
         getTagWithBugfix = function (value) {
             var result = getTag(value);
             var Ctor = result === objectTag ? value.constructor : undefined;
@@ -794,7 +780,7 @@
     }
 
     function isDate(value) {
-        return nodeIsDate ? nodeIsDate(value) : objectProtoToString.call(value) === dateTag;
+        return nodeIsDate ? nodeIsDate(value) : getTag(value) === dateTag;
     }
 
     var objectCtorString = functionProtoToString.call(Object);
@@ -836,22 +822,12 @@
         return result;
     }
 
-    function isMap(value) {
-        if (nodeIsMap) {
-            return nodeIsMap(value);
-        }
-        return getTagWithBugfix$1(value) === mapTag;
-    }
-
-    function isSet(value) {
-        return nodeIsSet ? nodeIsSet(value) : getTagWithBugfix$1(value) === setTag;
-    }
-
     function isEmpty(value) {
         if (value == null) {
             return true;
         }
-        if (isMap(value) || isSet(value)) {
+        var tag = getTag(value);
+        if (tag === mapTag || tag === setTag) {
             return !value.size;
         }
         if (isObjectLike(value)) {
@@ -886,7 +862,7 @@
             return nodeIsTypedArray(value);
         }
         if (isObjectLike(value) && isLength(value.length)) {
-            var tag_1 = objectProtoToString.call(value);
+            var tag_1 = getTag(value);
             return typedArrayTags.some(function (item) { return item === tag_1; });
         }
         return false;
@@ -945,7 +921,7 @@
             case symbolTag:
                 return symbolValueOf ? symbolValueOf.call(value) === symbolValueOf.call(other) : false;
             case errorTag:
-                return value.name == other.name && value.message == other.message;
+                return value.name === other.name && value.message === other.message;
             case dataViewTag:
             case arrayBufferTag:
                 if (value.byteLength !== other.byteLength || (value.byteOffset && value.byteOffset !== other.byteOffset)) {
@@ -1057,6 +1033,7 @@
         otherStack.pop();
         return result;
     }
+
     function isEqual(value, other, customizer, strictCheck) {
         if (strictCheck === void 0) { strictCheck = false; }
         if (typeof customizer === 'function') {
@@ -1075,7 +1052,7 @@
         if (value instanceof Error) {
             return true;
         }
-        var tag = objectProtoToString.call(value);
+        var tag = getTag(value);
         return tag === errorTag || tag === domExceptionTag;
     }
 
@@ -1092,11 +1069,17 @@
         return numberIsInteger ? numberIsInteger(value) : isFinite(value) && mathFloor(value) === value;
     }
 
+    function isMap(value) {
+        if (nodeIsMap) {
+            return nodeIsMap(value);
+        }
+        return getTagWithBugfix$1(value) === mapTag;
+    }
+
     function isDeepComparable(object, source) {
-        return objectProtoToString.call(object) === objectTag && objectProtoToString.call(source) === objectTag;
+        return getTag(object) === objectTag && getTag(source) === objectTag;
     }
-    function baseIsMatch(object, source, customizer, strictCheck, objStack, srcStack, executedCustomizer) {
-        if (executedCustomizer === void 0) { executedCustomizer = false; }
+    function baseIsMatch(object, source, customizer, strictCheck, objStack, srcStack) {
         var hasCustomizer = typeof customizer === 'function';
         if (isDeepComparable(object, source)) {
             objStack = objStack || [];
@@ -1125,7 +1108,7 @@
                         continue;
                     }
                 }
-                if (!baseIsMatch(object[key], source[key], customizer, strictCheck, objStack, srcStack, true)) {
+                if (!baseIsMatch(object[key], source[key], customizer, strictCheck, objStack, srcStack)) {
                     return false;
                 }
             }
@@ -1133,18 +1116,17 @@
             srcStack.pop();
             return true;
         }
-        var result = isEqual(object, source, function (objValue, srcValue, k, obj, src) {
-            if (!executedCustomizer && hasCustomizer) {
+        var result = isEqualDeep(object, source, function (objValue, srcValue, k, obj, src) {
+            if (hasCustomizer) {
                 var compared = customizer(objValue, srcValue, k, obj, src, objStack, srcStack);
                 if (compared !== undefined) {
                     return compared;
                 }
             }
-            executedCustomizer = false;
             if (isDeepComparable(objValue, srcValue)) {
                 return baseIsMatch(objValue, srcValue, customizer, strictCheck, objStack, srcStack);
             }
-        }, strictCheck);
+        }, strictCheck, objStack, srcStack);
         return result;
     }
     function isMatch(object, source, customizer, strictCheck) {
@@ -1155,11 +1137,11 @@
                 return !!compared;
             }
         }
-        return baseIsMatch(object, source, customizer, strictCheck, undefined, undefined, true);
+        return baseIsMatch(object, source, customizer, strictCheck, undefined, undefined);
     }
 
     function isNumber(value) {
-        return typeof value === 'number' || objectProtoToString.call(value) === numberTag;
+        return typeof value === 'number' || getTag(value) === numberTag;
     }
 
     function isNaN(value) {
@@ -1175,19 +1157,19 @@
     }
 
     function isRegExp(value) {
-        return nodeIsRegExp ? nodeIsRegExp(value) : objectProtoToString.call(value) === regExpTag;
+        return nodeIsRegExp ? nodeIsRegExp(value) : getTag(value) === regExpTag;
     }
 
     function isSafeInteger(value) {
         return numberIsSafeInteger ? numberIsSafeInteger(value) : isInteger(value) && mathAbs(value) <= MAX_SAFE_INTEGER;
     }
 
-    function isString(value) {
-        return typeof value === 'string' || objectProtoToString.call(value) === stringTag;
+    function isSet(value) {
+        return nodeIsSet ? nodeIsSet(value) : getTagWithBugfix$1(value) === setTag;
     }
 
-    function isUndefined(value) {
-        return value === void 0;
+    function isString(value) {
+        return typeof value === 'string' || getTag(value) === stringTag;
     }
 
     function isWeakMap(value) {
@@ -1195,7 +1177,7 @@
     }
 
     function isWeakSet(value) {
-        return objectProtoToString.call(value) === weakSetTag;
+        return getTag(value) === weakSetTag;
     }
 
     function decimalAdjust(type, value, precision) {
@@ -1242,41 +1224,37 @@
         return value <= other;
     };
 
-    function gt(value, other) {
-        return createOperation(baseGt)(value, other);
-    }
-
-    function createExtremum(array, iteratee, comparator) {
+    function createExtremum(array, comparator, iteratee) {
         if (!isArray(array)) {
             return;
         }
         var result, computed;
-        var internalIteratee = createIteratee(iteratee);
-        array.forEach(function (value) {
-            var current = internalIteratee(value);
-            if (current != null &&
-                (computed === undefined
-                    ? current === current && !isSymbol(current)
-                    : comparator(current, computed))) {
-                computed = current;
-                result = value;
-            }
-        });
+        if (isUndefined(iteratee)) {
+            array.forEach(function (value) {
+                if (value != null && (result === undefined ? value === value && !isSymbol(value) : comparator(value, result))) {
+                    result = value;
+                }
+            });
+        }
+        else {
+            var internalIteratee_1 = createIteratee(iteratee);
+            array.forEach(function (value) {
+                var current = internalIteratee_1(value);
+                if (current != null && (computed === undefined ? current === current && !isSymbol(current) : comparator(current, computed))) {
+                    computed = current;
+                    result = value;
+                }
+            });
+        }
         return result;
     }
 
     function max(array, iteratee) {
-        if (iteratee === void 0) { iteratee = identity; }
-        return createExtremum(array, iteratee, gt);
-    }
-
-    function lt(value, other) {
-        return createOperation(baseLt)(value, other);
+        return createExtremum(array, baseGt, iteratee);
     }
 
     function min(array, iteratee) {
-        if (iteratee === void 0) { iteratee = identity; }
-        return createExtremum(array, iteratee, lt);
+        return createExtremum(array, baseLt, iteratee);
     }
 
     function round(number, precision) {
@@ -1410,7 +1388,7 @@
         var fieldArr = castArray(fields);
         var result = {};
         keys.forEach(function (key) {
-            if (!fieldArr.includes(key)) {
+            if (fieldArr.indexOf(key) === -1) {
                 result[key] = object[key];
             }
         });
@@ -1418,7 +1396,7 @@
     }
 
     function pickBy(object, predicate) {
-        if (predicate === void 0) { predicate = function () { return false; }; }
+        if (predicate === void 0) { predicate = stubFlase; }
         var result = {};
         if (object === null) {
             return result;
@@ -1433,7 +1411,7 @@
     }
 
     function omitBy(object, predicate) {
-        if (predicate === void 0) { predicate = function () { return false; }; }
+        if (predicate === void 0) { predicate = stubFlase; }
         return pickBy(object, negate(predicate));
     }
 
@@ -1469,9 +1447,7 @@
         };
     }
 
-    function upperFirst(string) {
-        return createCaseFirst('toUpperCase')(string);
-    }
+    var upperFirst = createCaseFirst('toUpperCase');
 
     function camelCase(string, pattern) {
         return splitCaseWords(string, pattern).reduce(function (prev, cur, index) {
@@ -1518,9 +1494,7 @@
         return splitCaseWords(string, pattern).reduce(function (prev, cur, index) { return prev + (index ? ' ' : '') + cur.toLowerCase(); }, '');
     }
 
-    function lowerFirst(string) {
-        return createCaseFirst('toLowerCase')(string);
-    }
+    var lowerFirst = createCaseFirst('toLowerCase');
 
     function snakeCase(string, pattern) {
         return splitCaseWords(string, pattern).reduce(function (prev, cur, index) { return prev + (index ? '_' : '') + cur.toLowerCase(); }, '');
@@ -1580,13 +1554,13 @@
         };
     }
 
-    function gte(value, other) {
-        return createOperation(baseGte)(value, other);
-    }
+    var gt = createOperation(baseGt);
 
-    function lte(value, other) {
-        return createOperation(baseLte)(value, other);
-    }
+    var gte = createOperation(baseGte);
+
+    var lt = createOperation(baseLt);
+
+    var lte = createOperation(baseLte);
 
     function noop() { }