ut2 1.11.6 → 1.13.0

package/es/findKey.js

@@ -0,0 +1,40 @@
+import { __values, __read } from './node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js';
+import forEach from './forEach.js';
+import { stubFlase } from './internals/helpers.js';
+import isMap from './isMap.js';
+import isObject from './isObject.js';
+
+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;
+};
+
+export { findKey as default };

package/es/index.js

@@ -85,6 +85,7 @@ export { default as random } from './random.js';
 export { default as randomInt } from './randomInt.js';
 export { default as allKeys } from './allKeys.js';
 export { default as allKeysIn } from './allKeysIn.js';
+export { default as findKey } from './findKey.js';
 export { default as invert } from './invert.js';
 export { default as keys } from './keys.js';
 export { default as keysIn } from './keysIn.js';
@@ -121,6 +122,7 @@ export { default as noop } from './noop.js';
 export { default as nthArg } from './nthArg.js';
 export { default as range } from './range.js';
 export { default as sleep } from './sleep.js';
+export { default as list } from './list.js';
 export { default as times } from './times.js';
 export { default as toFinite } from './toFinite.js';
 export { default as toInteger } from './toInteger.js';
@@ -128,6 +130,7 @@ export { default as toLength } from './toLength.js';
 export { default as toNumber } from './toNumber.js';
 export { default as toSafeInteger } from './toSafeInteger.js';
 export { default as toString } from './toString.js';
+export { default as tryit } from './tryit.js';
 export { default as uniqueId } from './uniqueId.js';
 export { MAX_ARRAY_LENGTH, MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from './internals/native.js';
 export { VERSION, isBrowser } from './internals/helpers.js';

package/es/internals/helpers.js

@@ -2,7 +2,7 @@ import isObjectLike from '../isObjectLike.js';
 import getTag from './getTag.js';
 import { argumentsTag, stringUndefined, functionProtoToString } from './native.js';
 
-var VERSION = "1.11.6";
+var VERSION = "1.13.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';

package/es/list.js

@@ -0,0 +1,22 @@
+import identity from './identity.js';
+import { MAX_SAFE_INTEGER, mathMin, mathFloor, MAX_ARRAY_LENGTH } from './internals/native.js';
+import isInteger from './isInteger.js';
+import isFinite from './isFinite.js';
+
+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;
+};
+
+export { list as default };

package/es/node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js

@@ -0,0 +1,62 @@
+/******************************************************************************
+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 */
+
+
+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;
+};
+
+export { __read, __spreadArray, __values };

package/es/times.js

@@ -1,22 +1,5 @@
-import identity from './identity.js';
-import { MAX_SAFE_INTEGER, mathMin, mathFloor, MAX_ARRAY_LENGTH } from './internals/native.js';
-import isInteger from './isInteger.js';
-import isFinite from './isFinite.js';
+import list from './list.js';
 
-var times = 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 times = list;
 
 export { times as default };

package/es/tryit.js

@@ -0,0 +1,30 @@
+import { __spreadArray, __read } from './node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js';
+import { nativeUndefined } from './internals/native.js';
+import isPromiseLike from './isPromiseLike.js';
+
+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];
+        }
+    };
+};
+
+export { tryit as default };

package/lib/findKey.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var tslib_es6 = require('./node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js');
+var forEach = require('./forEach.js');
+var helpers = require('./internals/helpers.js');
+var isMap = require('./isMap.js');
+var isObject = require('./isObject.js');
+
+var findKey = function (obj, predicate) {
+    var e_1, _a;
+    if (predicate === void 0) { predicate = helpers.stubFlase; }
+    var key;
+    if (isMap(obj)) {
+        try {
+            for (var obj_1 = tslib_es6.__values(obj), obj_1_1 = obj_1.next(); !obj_1_1.done; obj_1_1 = obj_1.next()) {
+                var _b = tslib_es6.__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;
+};
+
+module.exports = findKey;

package/lib/index.js

@@ -87,6 +87,7 @@ var random = require('./random.js');
 var randomInt = require('./randomInt.js');
 var allKeys = require('./allKeys.js');
 var allKeysIn = require('./allKeysIn.js');
+var findKey = require('./findKey.js');
 var invert = require('./invert.js');
 var keys = require('./keys.js');
 var keysIn = require('./keysIn.js');
@@ -123,6 +124,7 @@ var noop = require('./noop.js');
 var nthArg = require('./nthArg.js');
 var range = require('./range.js');
 var sleep = require('./sleep.js');
+var list = require('./list.js');
 var times = require('./times.js');
 var toFinite = require('./toFinite.js');
 var toInteger = require('./toInteger.js');
@@ -130,6 +132,7 @@ var toLength = require('./toLength.js');
 var toNumber = require('./toNumber.js');
 var toSafeInteger = require('./toSafeInteger.js');
 var toString = require('./toString.js');
+var tryit = require('./tryit.js');
 var uniqueId = require('./uniqueId.js');
 var native = require('./internals/native.js');
 var helpers = require('./internals/helpers.js');
@@ -224,6 +227,7 @@ exports.random = random;
 exports.randomInt = randomInt;
 exports.allKeys = allKeys;
 exports.allKeysIn = allKeysIn;
+exports.findKey = findKey;
 exports.invert = invert;
 exports.keys = keys;
 exports.keysIn = keysIn;
@@ -260,6 +264,7 @@ exports.noop = noop;
 exports.nthArg = nthArg;
 exports.range = range;
 exports.sleep = sleep;
+exports.list = list;
 exports.times = times;
 exports.toFinite = toFinite;
 exports.toInteger = toInteger;
@@ -267,6 +272,7 @@ exports.toLength = toLength;
 exports.toNumber = toNumber;
 exports.toSafeInteger = toSafeInteger;
 exports.toString = toString;
+exports.tryit = tryit;
 exports.uniqueId = uniqueId;
 exports.MAX_ARRAY_LENGTH = native.MAX_ARRAY_LENGTH;
 exports.MAX_SAFE_INTEGER = native.MAX_SAFE_INTEGER;

package/lib/internals/helpers.js

@@ -4,7 +4,7 @@ var isObjectLike = require('../isObjectLike.js');
 var getTag = require('./getTag.js');
 var native = require('./native.js');
 
-var VERSION = "1.11.6";
+var VERSION = "1.13.0";
 var isBrowser = typeof window !== native.stringUndefined && isObjectLike(window) && typeof document !== native.stringUndefined && isObjectLike(document) && window.document === document;
 var supportedArgumentsType = getTag((function () { return arguments; })()) === native.argumentsTag;
 var FUNC_ERROR_TEXT = 'Expected a function';

package/lib/list.js

@@ -0,0 +1,24 @@
+'use strict';
+
+var identity = require('./identity.js');
+var native = require('./internals/native.js');
+var isInteger = require('./isInteger.js');
+var isFinite = require('./isFinite.js');
+
+var list = function (n, iteratee) {
+    if (iteratee === void 0) { iteratee = identity; }
+    if (n < 1 || n > native.MAX_SAFE_INTEGER) {
+        return [];
+    }
+    var index = 0;
+    var length = native.mathMin(isInteger(n) ? n : native.mathFloor(isFinite(n) ? n : 0), native.MAX_ARRAY_LENGTH);
+    var result = Array(length);
+    var func = typeof iteratee === 'function' ? iteratee : identity;
+    while (index < length) {
+        result[index] = func(index);
+        index++;
+    }
+    return result;
+};
+
+module.exports = list;

package/lib/node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js

@@ -0,0 +1,66 @@
+'use strict';
+
+/******************************************************************************
+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 */
+
+
+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;
+};
+
+exports.__read = __read;
+exports.__spreadArray = __spreadArray;
+exports.__values = __values;

package/lib/times.js

@@ -1,24 +1,7 @@
 'use strict';
 
-var identity = require('./identity.js');
-var native = require('./internals/native.js');
-var isInteger = require('./isInteger.js');
-var isFinite = require('./isFinite.js');
+var list = require('./list.js');
 
-var times = function (n, iteratee) {
-    if (iteratee === void 0) { iteratee = identity; }
-    if (n < 1 || n > native.MAX_SAFE_INTEGER) {
-        return [];
-    }
-    var index = 0;
-    var length = native.mathMin(isInteger(n) ? n : native.mathFloor(isFinite(n) ? n : 0), native.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 times = list;
 
 module.exports = times;

package/lib/tryit.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var tslib_es6 = require('./node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js');
+var native = require('./internals/native.js');
+var isPromiseLike = require('./isPromiseLike.js');
+
+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, tslib_es6.__spreadArray([], tslib_es6.__read(args), false));
+            if (isPromiseLike(result)) {
+                return result
+                    .then(function (res) {
+                    return [null, res];
+                })
+                    .catch(function (err) {
+                    return [err, native.nativeUndefined];
+                });
+            }
+            return [null, result];
+        }
+        catch (err) {
+            return [err, native.nativeUndefined];
+        }
+    };
+};
+
+module.exports = tryit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ut2",
-  "version": "1.11.6",
+  "version": "1.13.0",
   "author": "caijf",
   "license": "MIT",
   "main": "lib/index.js",

package/types/allKeys.d.ts

@@ -3,6 +3,8 @@
  *
  * 同 `Object.keys` + `Object.getOwnPropertySymbols`。
  *
+ * 注意：`Symbol` 键属性在字符串属性后面。
+ *
  * @static
  * @alias module:Object.allKeys
  * @since 1.1.0

package/types/allKeysIn.d.ts

@@ -3,6 +3,8 @@
  *
  * 同 `key...in` + 递归原型 `Object.getOwnPropertySymbols`。
  *
+ * 注意：`Symbol` 键属性在字符串属性后面。
+ *
  * @static
  * @alias module:Object.allKeysIn
  * @since 1.1.0

package/types/findKey.d.ts

@@ -0,0 +1,24 @@
+import { MapKey, MapPredicate, ObjectPredicate, WithNullable } from './internals/types';
+interface FindKey {
+    <T extends Map<any, any>>(map: WithNullable<T>, predicate?: MapPredicate<T>): MapKey<T> | undefined;
+    <T extends object, K extends keyof T = keyof T>(object: WithNullable<T>, predicate?: ObjectPredicate<T>): K | undefined;
+}
+/**
+ * 查找对象的键。
+ *
+ * @alias module:Object.findKey
+ * @since 1.13.0
+ * @param {Object | Map} obj 对象或 Map 对象
+ * @param {Function} [predicate] 迭代对象自身的可枚举属性（包含 `Symbol` 属性）调用的函数，返回 `Truthy` 表示要查找该值对应的键。
+ * @returns 如果对象存在要查找的值，返回该值的键，否则返回 `undefined`。
+ * @example
+ * const obj = { foo: 'bar', baz: 42 }
+ * findKey(obj, isNumber); // 'baz'
+ * findKey(obj, v => typeof v === 'bar'); // 'foo'
+ *
+ * const map = new Map([['foo', 'bar'], ['baz', 42]]);
+ * findKey(map, isNumber); // 'baz'
+ * findKey(map, v => typeof v === 'bar'); // 'foo'
+ */
+declare const findKey: FindKey;
+export default findKey;

package/types/index.d.ts

@@ -127,6 +127,7 @@ export { default as randomInt } from './randomInt';
  */
 export { default as allKeys } from './allKeys';
 export { default as allKeysIn } from './allKeysIn';
+export { default as findKey } from './findKey';
 export { default as invert } from './invert';
 export { default as keys } from './keys';
 export { default as keysIn } from './keysIn';
@@ -175,6 +176,7 @@ export { default as noop } from './noop';
 export { default as nthArg } from './nthArg';
 export { default as range } from './range';
 export { default as sleep } from './sleep';
+export { default as list } from './list';
 export { default as times } from './times';
 export { default as toFinite } from './toFinite';
 export { default as toInteger } from './toInteger';
@@ -182,6 +184,7 @@ export { default as toLength } from './toLength';
 export { default as toNumber } from './toNumber';
 export { default as toSafeInteger } from './toSafeInteger';
 export { default as toString } from './toString';
+export { default as tryit } from './tryit';
 export { default as uniqueId } from './uniqueId';
 export { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, MAX_ARRAY_LENGTH } from './internals/native';
 export { VERSION, isBrowser } from './internals/helpers';

package/types/internals/types.d.ts

@@ -6,6 +6,9 @@ export type Many<T> = T | T[];
 export type WithNullable<T> = T | null | undefined;
 export type PropertyName = string | number | symbol;
 export type ObjectPredicate<T extends object, K extends keyof T = keyof T> = (value: T[K], key: K) => boolean;
+export type MapValue<T extends Map<any, any>> = ReturnType<T['get']>;
+export type MapKey<T extends Map<any, any>> = Parameters<T['get']>[0];
+export type MapPredicate<T extends Map<any, any>> = (value: MapValue<T>, key: MapKey<T>) => boolean;
 /**
  * 迭代参数
  */

package/types/isWindow.d.ts

@@ -17,5 +17,5 @@
  * isWindow(frames); // true
  *
  */
-declare function isWindow(value: any): value is Window & typeof globalThis;
+declare function isWindow(value: any): value is Window;
 export default isWindow;

package/types/list.d.ts

@@ -0,0 +1,28 @@
+interface List {
+    <T>(n: number, iteratee: (index: number) => T): T[];
+    (n: number): number[];
+}
+/**
+ * 调用 `iteratee` `n` 次，每次调用返回的结果存入到数组中。
+ *
+ * `iteratee` 调用传入一个参数 `index`。
+ *
+ * *注：原方法名为 `times`，自 `v1.12.0` 版本调整为 `list`。*
+ *
+ * @function
+ * @alias module:Util.list
+ * @since 1.12.0
+ * @param {number} n 调用 `iteratee` 的次数。
+ * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
+ * @returns {Array} 调用结果的数组。
+ * @example
+ *
+ * list(3); // [0, 1, 2]
+ *
+ * list(3, String); // ['0', '1', '2']
+ *
+ * list(4, () => 0); // [0, 0, 0, 0]
+ *
+ */
+declare const list: List;
+export default list;

package/types/times.d.ts

@@ -1,26 +1,8 @@
-interface Times {
-    <T>(n: number, iteratee: (index: number) => T): T[];
-    (n: number): number[];
-}
+import list from './list';
+type Times = typeof list;
 /**
- * 调用 `iteratee` `n` 次，每次调用返回的结果存入到数组中。
- *
- * `iteratee` 调用传入一个参数 `index`。
- *
- * @function
- * @alias module:Util.times
- * @since 1.0.0
- * @param {number} n 调用 `iteratee` 的次数。
- * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
- * @returns {Array} 调用结果的数组。
- * @example
- *
- * times(3); // [0, 1, 2]
- *
- * times(3, String); // ['0', '1', '2']
- *
- * times(4, () => 0); // [0, 0, 0, 0]
- *
+ * @private
+ * @deprecated 方法名调整为 `list` 。
  */
 declare const times: Times;
 export default times;

package/types/tryit.d.ts

@@ -0,0 +1,32 @@
+type SyncFn<P extends any[], R> = (...args: P) => R;
+type AsyncFn<P extends any[], R> = (...args: P) => Promise<R>;
+interface Tryit {
+    <P extends any[], R>(fn: AsyncFn<P, R>): (...args: P) => Promise<[null, R] | [Error, undefined]>;
+    <P extends any[], R>(fn: SyncFn<P, R>): (...args: P) => [null, R] | [Error, undefined];
+}
+/**
+ * 包装一个函数（支持异步函数），将其转为错误优先函数。
+ *
+ * @alias module:Util.tryit
+ * @since 1.13.0
+ * @param {Function} fn 要包装的函数。
+ * @returns 如果执行成功返回 `[null, result]`，否则返回 `[Error, undefined]`。
+ * @example
+ * const getGreet = async (name: string) => {
+ *   return 'hello ' + name;
+ * }
+ * const [err, result] = await tryit(getGreet)('jeff');
+ * console.log([err, result]);
+ * // [null, 'hello jeff']
+ *
+ *
+ * const errorFn = async (name: string) => {
+ *   throw new Error('error message');
+ *   return 'hello ' + name;
+ * }
+ * const [err2, result2] = await tryit(errorFn)('jeff');
+ * console.log([err2, result2]);
+ * // [Error: error message, undefined]
+ */
+declare const tryit: Tryit;
+export default tryit;