ut2 1.12.0 → 1.14.0

package/README.md

@@ -154,6 +154,7 @@ const debounced = debounce(() => {
 - [Object](https://caijf.github.io/ut2/module-Object.html) 对象
   - [allKeys](https://caijf.github.io/ut2/module-Object.html#.allKeys) - 对象自身的可枚举属性（包含 `Symbol` 属性）。
   - [allKeysIn](https://caijf.github.io/ut2/module-Object.html#.allKeysIn) - 对象自身及继承的可枚举属性（包含 `Symbol` 属性）。
+  - [findKey](https://caijf.github.io/ut2/module-Object.html#.findKey) - 查找对象的键。
   - [invert](https://caijf.github.io/ut2/module-Object.html#.invert) - 对象自身的可枚举属性（包含 `Symbol` 属性）和值反转。
   - [keys](https://caijf.github.io/ut2/module-Object.html#.keys) - 对象自身的可枚举属性（不包含 `Symbol` 属性）。
   - [keysIn](https://caijf.github.io/ut2/module-Object.html#.keysIn) - 对象自身及继承的可枚举属性（不包含 `Symbol` 属性）。
@@ -184,7 +185,8 @@ const debounced = debounce(() => {
   - [defaultTo](https://caijf.github.io/ut2/module-Util.html#.defaultTo) - 默认值。
   - [eq](https://caijf.github.io/ut2/module-Util.html#.eq) - 等于。
   - [gt](https://caijf.github.io/ut2/module-Util.html#.gt) - 大于。
-  - [gte](https://caijf.github.io/ut2/module-Util.html#.gte) - 大于等于
+  - [gte](https://caijf.github.io/ut2/module-Util.html#.gte) - 大于等于。
+  - [guard](https://caijf.github.io/ut2/module-Util.html#.guard) - 函数守卫。
   - [identity](https://caijf.github.io/ut2/module-Util.html#.identity) - 返回第一个参数的函数。
   - [list](https://caijf.github.io/ut2/module-Util.html#.list) - 迭代执行次数。
   - [lt](https://caijf.github.io/ut2/module-Util.html#.lt) - 小于。
@@ -192,6 +194,7 @@ const debounced = debounce(() => {
   - [noop](https://caijf.github.io/ut2/module-Util.html#.noop) - 空函数。
   - [nthArg](https://caijf.github.io/ut2/module-Util.html#.nthArg) - 返回指定位置参数的函数。
   - [range](https://caijf.github.io/ut2/module-Util.html#.range) - 创建升序或降序的数字数组。
+  - [retry](https://caijf.github.io/ut2/module-Util.html#.retry) - 异步函数错误重试。
   - [sleep](https://caijf.github.io/ut2/module-Util.html#.sleep) - 返回 `promise` 延迟。
   - [toFinite](https://caijf.github.io/ut2/module-Util.html#.toFinite) - 转为有限数字。
   - [toInteger](https://caijf.github.io/ut2/module-Util.html#.toInteger) - 转为整数。
@@ -199,6 +202,7 @@ const debounced = debounce(() => {
   - [toNumber](https://caijf.github.io/ut2/module-Util.html#.toNumber) - 转为数字。
   - [toSafeInteger](https://caijf.github.io/ut2/module-Util.html#.toSafeInteger) - 转为安全整数。
   - [toString](https://caijf.github.io/ut2/module-Util.html#.toString) - 转为字符串。
+  - [tryit](https://caijf.github.io/ut2/module-Util.html#.tryit) - 包装函数为错误优先函数。
   - [uniqueId](https://caijf.github.io/ut2/module-Util.html#.uniqueId) - 唯一 ID。
 - [GLOBAL](https://caijf.github.io/ut2/global.html) 其他导出的成员
   - [MAX_ARRAY_LENGTH](https://caijf.github.io/ut2/global.html#MAX_ARRAY_LENGTH) - 最大数组长度。

package/dist/ut2.js

@@ -606,7 +606,7 @@
         return value == null || value !== value ? defaultValue : value;
     };
 
-    var VERSION = "1.12.0";
+    var VERSION = "1.14.0";
     var isBrowser = typeof window !== stringUndefined && isObjectLike(window) && typeof document !== stringUndefined && isObjectLike(document) && window.document === document;
     var supportedArgumentsType = getTag((function () { return arguments; })()) === argumentsTag;
     var FUNC_ERROR_TEXT = 'Expected a function';
@@ -1430,6 +1430,138 @@
         return getKeysIn(object).concat(getSymbolsIn(object));
     }
 
+    /******************************************************************************
+    Copyright (c) Microsoft Corporation.
+
+    Permission to use, copy, modify, and/or distribute this software for any
+    purpose with or without fee is hereby granted.
+
+    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+    PERFORMANCE OF THIS SOFTWARE.
+    ***************************************************************************** */
+    /* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+    function __awaiter(thisArg, _arguments, P, generator) {
+        function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+        return new (P || (P = Promise))(function (resolve, reject) {
+            function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+            function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+            function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+            step((generator = generator.apply(thisArg, _arguments || [])).next());
+        });
+    }
+
+    function __generator(thisArg, body) {
+        var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+        return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+        function verb(n) { return function (v) { return step([n, v]); }; }
+        function step(op) {
+            if (f) throw new TypeError("Generator is already executing.");
+            while (g && (g = 0, op[0] && (_ = 0)), _) try {
+                if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+                if (y = 0, t) op = [op[0] & 2, t.value];
+                switch (op[0]) {
+                    case 0: case 1: t = op; break;
+                    case 4: _.label++; return { value: op[1], done: false };
+                    case 5: _.label++; y = op[1]; op = [0]; continue;
+                    case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                    default:
+                        if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                        if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                        if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                        if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                        if (t[2]) _.ops.pop();
+                        _.trys.pop(); continue;
+                }
+                op = body.call(thisArg, _);
+            } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+            if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+        }
+    }
+
+    function __values(o) {
+        var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+        if (m) return m.call(o);
+        if (o && typeof o.length === "number") return {
+            next: function () {
+                if (o && i >= o.length) o = void 0;
+                return { value: o && o[i++], done: !o };
+            }
+        };
+        throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+    }
+
+    function __read(o, n) {
+        var m = typeof Symbol === "function" && o[Symbol.iterator];
+        if (!m) return o;
+        var i = m.call(o), r, ar = [], e;
+        try {
+            while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+        }
+        catch (error) { e = { error: error }; }
+        finally {
+            try {
+                if (r && !r.done && (m = i["return"])) m.call(i);
+            }
+            finally { if (e) throw e.error; }
+        }
+        return ar;
+    }
+
+    function __spreadArray(to, from, pack) {
+        if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+            if (ar || !(i in from)) {
+                if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+                ar[i] = from[i];
+            }
+        }
+        return to.concat(ar || Array.prototype.slice.call(from));
+    }
+
+    typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+        var e = new Error(message);
+        return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+    };
+
+    var findKey = function (obj, predicate) {
+        var e_1, _a;
+        if (predicate === void 0) { predicate = stubFlase; }
+        var key;
+        if (isMap(obj)) {
+            try {
+                for (var obj_1 = __values(obj), obj_1_1 = obj_1.next(); !obj_1_1.done; obj_1_1 = obj_1.next()) {
+                    var _b = __read(obj_1_1.value, 2), k = _b[0], v = _b[1];
+                    if (predicate(v, k)) {
+                        key = k;
+                        break;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (obj_1_1 && !obj_1_1.done && (_a = obj_1.return)) _a.call(obj_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        else if (isObject(obj)) {
+            forEach(obj, function (v, k) {
+                if (predicate(v, k)) {
+                    key = k;
+                    return false;
+                }
+            });
+        }
+        return key;
+    };
+
     function invert(object, predicate) {
         if (predicate === void 0) { predicate = stubTrue; }
         var _keys = allKeys(object);
@@ -1697,6 +1829,38 @@
 
     var gte = createOperation(baseGte);
 
+    var guard = function (fn, shouldGuard) {
+        var _guard = function (err) {
+            if (shouldGuard && !shouldGuard(err)) {
+                throw err;
+            }
+            return undefined;
+        };
+        try {
+            var result = fn();
+            return isPromiseLike(result) ? result.catch(_guard) : result;
+        }
+        catch (err) {
+            return _guard(err);
+        }
+    };
+
+    var list = function (n, iteratee) {
+        if (iteratee === void 0) { iteratee = identity; }
+        if (n < 1 || n > MAX_SAFE_INTEGER) {
+            return [];
+        }
+        var index = 0;
+        var length = mathMin(isInteger(n) ? n : mathFloor(isFinite(n) ? n : 0), MAX_ARRAY_LENGTH);
+        var result = Array(length);
+        var func = typeof iteratee === 'function' ? iteratee : identity;
+        while (index < length) {
+            result[index] = func(index);
+            index++;
+        }
+        return result;
+    };
+
     var lt = createOperation(baseLt);
 
     var lte = createOperation(baseLte);
@@ -1744,22 +1908,69 @@
         });
     }
 
-    var list = function (n, iteratee) {
-        if (iteratee === void 0) { iteratee = identity; }
-        if (n < 1 || n > MAX_SAFE_INTEGER) {
-            return [];
-        }
-        var index = 0;
-        var length = mathMin(isInteger(n) ? n : mathFloor(isFinite(n) ? n : 0), MAX_ARRAY_LENGTH);
-        var result = Array(length);
-        var func = typeof iteratee === 'function' ? iteratee : identity;
-        while (index < length) {
-            result[index] = func(index);
-            index++;
-        }
-        return result;
+    var tryit = function (fn) {
+        return function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            try {
+                var result = fn.apply(void 0, __spreadArray([], __read(args), false));
+                if (isPromiseLike(result)) {
+                    return result
+                        .then(function (res) {
+                        return [null, res];
+                    })
+                        .catch(function (err) {
+                        return [err, nativeUndefined];
+                    });
+                }
+                return [null, result];
+            }
+            catch (err) {
+                return [err, nativeUndefined];
+            }
+        };
     };
 
+    function retry(fn, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, times, delay, backoff, exit, i, _c, err, result;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        _a = options || {}, _b = _a.times, times = _b === void 0 ? 3 : _b, delay = _a.delay, backoff = _a.backoff, exit = _a.exit;
+                        i = 1;
+                        _d.label = 1;
+                    case 1:
+                        if (!(i <= times)) return [3, 7];
+                        return [4, tryit(fn)()];
+                    case 2:
+                        _c = __read.apply(void 0, [_d.sent(), 2]), err = _c[0], result = _c[1];
+                        if (!err)
+                            return [2, result];
+                        if ((exit && exit(err, i)) || i === times)
+                            throw err;
+                        if (!delay) return [3, 4];
+                        return [4, sleep(delay)];
+                    case 3:
+                        _d.sent();
+                        _d.label = 4;
+                    case 4:
+                        if (!backoff) return [3, 6];
+                        return [4, sleep(backoff(i))];
+                    case 5:
+                        _d.sent();
+                        _d.label = 6;
+                    case 6:
+                        i++;
+                        return [3, 1];
+                    case 7: return [2];
+                }
+            });
+        });
+    }
+
     var times = list;
 
     function toSafeInteger(value) {
@@ -1813,6 +2024,7 @@
     exports.every = every;
     exports.filter = filter;
     exports.find = find;
+    exports.findKey = findKey;
     exports.floor = floor;
     exports.forEach = forEach;
     exports.forEachRight = forEachRight;
@@ -1820,6 +2032,7 @@
     exports.groupBy = groupBy;
     exports.gt = gt;
     exports.gte = gte;
+    exports.guard = guard;
     exports.identity = identity;
     exports.inRange = inRange;
     exports.intersection = intersection;
@@ -1897,6 +2110,7 @@
     exports.range = range;
     exports.reduce = reduce;
     exports.reduceRight = reduceRight;
+    exports.retry = retry;
     exports.root = root;
     exports.round = round;
     exports.shuffle = shuffle;
@@ -1911,6 +2125,7 @@
     exports.toNumber = toNumber;
     exports.toSafeInteger = toSafeInteger;
     exports.toString = toString;
+    exports.tryit = tryit;
     exports.unescape = unescape;
     exports.union = union;
     exports.uniq = uniq;