ut2 1.9.3 → 1.9.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/dist/ut2.js +3 -6
  2. package/dist/ut2.js.map +1 -1
  3. package/dist/ut2.min.js +1 -1
  4. package/dist/ut2.min.js.map +1 -1
  5. package/es/internals/helpers.js +1 -1
  6. package/es/isBuffer.js +2 -5
  7. package/lib/internals/helpers.js +1 -1
  8. package/lib/isBuffer.js +2 -5
  9. package/package.json +1 -1
  10. package/types/after.d.ts +1 -1
  11. package/types/ceil.d.ts +2 -2
  12. package/types/chunk.d.ts +1 -1
  13. package/types/clamp.d.ts +3 -3
  14. package/types/conforms.d.ts +1 -1
  15. package/types/conformsTo.d.ts +2 -2
  16. package/types/countBy.d.ts +1 -1
  17. package/types/curry.d.ts +1 -1
  18. package/types/debounce.d.ts +2 -2
  19. package/types/defaultTo.d.ts +2 -2
  20. package/types/delay.d.ts +2 -2
  21. package/types/difference.d.ts +3 -3
  22. package/types/eq.d.ts +2 -2
  23. package/types/escapeRegExp.d.ts +1 -1
  24. package/types/every.d.ts +4 -4
  25. package/types/filter.d.ts +2 -2
  26. package/types/find.d.ts +3 -3
  27. package/types/floor.d.ts +2 -2
  28. package/types/forEach.d.ts +3 -3
  29. package/types/forEachRight.d.ts +3 -3
  30. package/types/groupBy.d.ts +2 -2
  31. package/types/gt.d.ts +2 -2
  32. package/types/gte.d.ts +2 -2
  33. package/types/identity.d.ts +1 -1
  34. package/types/inRange.d.ts +3 -3
  35. package/types/internals/getTag.d.ts +1 -1
  36. package/types/internals/isEqualDeep.d.ts +3 -3
  37. package/types/internals/native.d.ts +1 -1
  38. package/types/intersection.d.ts +3 -3
  39. package/types/invert.d.ts +2 -1
  40. package/types/isArguments.d.ts +1 -1
  41. package/types/isArray.d.ts +1 -1
  42. package/types/isArrayBuffer.d.ts +1 -1
  43. package/types/isArrayLike.d.ts +1 -1
  44. package/types/isArrayLikeObject.d.ts +6 -2
  45. package/types/isBigInt.d.ts +1 -1
  46. package/types/isBlob.d.ts +2 -2
  47. package/types/isBoolean.d.ts +1 -1
  48. package/types/isBuffer.d.ts +3 -3
  49. package/types/isDataView.d.ts +1 -1
  50. package/types/isDate.d.ts +1 -1
  51. package/types/isElement.d.ts +1 -1
  52. package/types/isEmpty.d.ts +1 -1
  53. package/types/isEqual.d.ts +3 -3
  54. package/types/isError.d.ts +3 -3
  55. package/types/isFinite.d.ts +2 -2
  56. package/types/isFunction.d.ts +3 -3
  57. package/types/isInteger.d.ts +2 -2
  58. package/types/isLength.d.ts +1 -1
  59. package/types/isMap.d.ts +1 -1
  60. package/types/isMatch.d.ts +3 -3
  61. package/types/isNaN.d.ts +2 -2
  62. package/types/isNil.d.ts +2 -2
  63. package/types/isNull.d.ts +2 -2
  64. package/types/isNumber.d.ts +1 -1
  65. package/types/isObject.d.ts +1 -1
  66. package/types/isObjectLike.d.ts +1 -1
  67. package/types/isPlainObject.d.ts +1 -1
  68. package/types/isPromiseLike.d.ts +1 -1
  69. package/types/isRegExp.d.ts +1 -1
  70. package/types/isSafeInteger.d.ts +2 -2
  71. package/types/isSet.d.ts +1 -1
  72. package/types/isString.d.ts +1 -1
  73. package/types/isSymbol.d.ts +1 -1
  74. package/types/isTypedArray.d.ts +1 -1
  75. package/types/isUndefined.d.ts +2 -2
  76. package/types/isWeakMap.d.ts +1 -1
  77. package/types/isWeakSet.d.ts +1 -1
  78. package/types/keyBy.d.ts +2 -2
  79. package/types/keys.d.ts +1 -1
  80. package/types/keysIn.d.ts +1 -1
  81. package/types/lt.d.ts +2 -2
  82. package/types/lte.d.ts +2 -2
  83. package/types/map.d.ts +2 -2
  84. package/types/max.d.ts +1 -1
  85. package/types/merge.d.ts +4 -4
  86. package/types/min.d.ts +1 -1
  87. package/types/noop.d.ts +1 -1
  88. package/types/nth.d.ts +1 -1
  89. package/types/nthArg.d.ts +1 -1
  90. package/types/omitBy.d.ts +3 -2
  91. package/types/orderBy.d.ts +1 -1
  92. package/types/partial.d.ts +1 -1
  93. package/types/partition.d.ts +5 -3
  94. package/types/pickBy.d.ts +3 -2
  95. package/types/random.d.ts +2 -2
  96. package/types/randomInt.d.ts +3 -3
  97. package/types/range.d.ts +3 -3
  98. package/types/reduce.d.ts +2 -2
  99. package/types/reduceRight.d.ts +2 -2
  100. package/types/round.d.ts +2 -2
  101. package/types/sleep.d.ts +1 -1
  102. package/types/some.d.ts +4 -4
  103. package/types/throttle.d.ts +2 -2
  104. package/types/times.d.ts +2 -2
  105. package/types/toInteger.d.ts +1 -1
  106. package/types/toString.d.ts +1 -1
  107. package/types/union.d.ts +2 -2
  108. package/types/uniq.d.ts +2 -2
  109. package/types/uniqueId.d.ts +2 -2
  110. package/types/words.d.ts +1 -1
  111. package/types/xor.d.ts +3 -3
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isDataView
6
6
  * @since 1.2.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `DataView` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `DataView` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isDataView(new DataView(new ArrayBuffer(8))); // true
package/types/isDate.d.ts CHANGED
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isDate
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `Date` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `Date` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isDate(new Date); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isElement
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `DOM` 元素,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `DOM` 元素,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isElement(document.body); // true
@@ -9,7 +9,7 @@
9
9
  * @alias module:Language.isEmpty
10
10
  * @since 1.0.0
11
11
  * @param {*} value 要检查的值。
12
- * @returns {boolean} 如果值为空,返回 `true` ,否则返回 `false` 。
12
+ * @returns {boolean} 如果值为空,返回 `true`,否则返回 `false`。
13
13
  * @example
14
14
  *
15
15
  * isEmpty(null); // true
@@ -4,7 +4,7 @@ import isEqualDeep from './internals/isEqualDeep';
4
4
  *
5
5
  * 支持比较 `boolean` `number` `string` `symbol` `array` `array buffer` `date` `error` `map` `object` `regexp` `set` `typed array` 类型。对象只比较自身的属性,不包括继承和不可枚举的属性。
6
6
  *
7
- * 如果 `strictCheck=true` , 以下值不相等:
7
+ * 如果 `strictCheck=true`, 以下值不相等:
8
8
  *
9
9
  * 1. `0` `-0`
10
10
  * 2. `typeof` 不同类型,如 `1` `Object(1)`
@@ -16,8 +16,8 @@ import isEqualDeep from './internals/isEqualDeep';
16
16
  * @param {*} value 要比较的值。
17
17
  * @param {*} other 另一个要比较的值。
18
18
  * @param {Function} [customizer] 自定义比较。
19
- * @param {boolean} [strictCheck=false] 严格比较,默认 `false` 。
20
- * @returns {boolean} 如果两个值相等,返回 `true` ,否则返回 `false` 。
19
+ * @param {boolean} [strictCheck=false] 严格比较。默认 `false`。
20
+ * @returns {boolean} 如果两个值相等,返回 `true`,否则返回 `false`。
21
21
  * @example
22
22
  *
23
23
  * const value = { a: 1, b: -0 }
@@ -1,13 +1,13 @@
1
1
  /**
2
- * 检查值是否为 `Error` 或 `DOMException` 。
2
+ * 检查值是否为 `Error` 或 `DOMException`。
3
3
  *
4
- * 继承自 `Error` 的对象,如 `EvalError` `RangeError` `ReferenceError` `SyntaxError` `TypeError` `URIError` `AggregateError`,都将返回 `true` 。
4
+ * 继承自 `Error` 的对象,如 `EvalError` `RangeError` `ReferenceError` `SyntaxError` `TypeError` `URIError` `AggregateError`,都将返回 `true`。
5
5
  *
6
6
  * @static
7
7
  * @alias module:Language.isError
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为 `Error` 或 `DOMException` 对象,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为 `Error` 或 `DOMException` 对象,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isError(new Error); // true
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * 检查值是否为有限数字。
3
3
  *
4
- * 同 `Number.isFinite` 。
4
+ * 同 `Number.isFinite`。
5
5
  *
6
6
  * @static
7
7
  * @alias module:Language.isFinite
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为有限数字,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为有限数字,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isFinite(1); // true
@@ -1,14 +1,14 @@
1
1
  import { FunctionAny } from './internals/types';
2
2
  /**
3
- * 检查值是否为 `Function` 对象 。
3
+ * 检查值是否为 `Function` 对象。
4
4
  *
5
- * `Function` `AsyncFunction` `GeneratorFunction` `Proxy` 都将返回 `true` 。
5
+ * `Function` `AsyncFunction` `GeneratorFunction` `Proxy` 都将返回 `true`。
6
6
  *
7
7
  * @static
8
8
  * @alias module:Language.isFunction
9
9
  * @since 1.0.0
10
10
  * @param {*} value 要检查的值。
11
- * @returns {boolean} 如果值为 `Function` 对象,返回 `true` ,否则返回 `false` 。
11
+ * @returns {boolean} 如果值为 `Function` 对象,返回 `true`,否则返回 `false`。
12
12
  * @example
13
13
  *
14
14
  * isFunction(()=>{})); // true
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * 检查值是否为整数。
3
3
  *
4
- * 同 `Number.isInteger` 。
4
+ * 同 `Number.isInteger`。
5
5
  *
6
6
  * @static
7
7
  * @alias module:Language.isInteger
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为整数,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为整数,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isInteger(1); // true
@@ -6,7 +6,7 @@
6
6
  * @since 1.0.0
7
7
  * @see {@link https://tc39.es/ecma262/#sec-tolength ToLength}
8
8
  * @param {*} value 要检查的值。
9
- * @returns {boolean} 如果值为有效的类数组长度,返回 `true` ,否则返回 `false` 。
9
+ * @returns {boolean} 如果值为有效的类数组长度,返回 `true`,否则返回 `false`。
10
10
  * @example
11
11
  *
12
12
  * isLength(3); // true
package/types/isMap.d.ts CHANGED
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isMap
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `Map` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `Map` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isMap(new Map); // true
@@ -4,7 +4,7 @@ type Customizer = (objValue: any, srcValue: any, key?: number | string | symbol,
4
4
  *
5
5
  * 注意:只有普通对象才会执行部分匹配,函数、数组不会执行部分匹配。
6
6
  *
7
- * 如果 `strictCheck=true` , 以下值不相等:
7
+ * 如果 `strictCheck=true`, 以下值不相等:
8
8
  *
9
9
  * 1. `0` `-0`
10
10
  * 2. `typeof` 不同类型,如 `1` `Object(1)`
@@ -17,8 +17,8 @@ type Customizer = (objValue: any, srcValue: any, key?: number | string | symbol,
17
17
  * @param {Object} object 要检查的对象。
18
18
  * @param {Object} source 属性值相匹配的对象。
19
19
  * @param {Function} [customizer] 自定义比较。
20
- * @param {boolean} [strictCheck=false] 严格比较。
21
- * @returns {boolean} 如果 `object` 匹配,返回 `true` ,否则返回 `false` 。
20
+ * @param {boolean} [strictCheck=false] 严格比较。默认 `false`。
21
+ * @returns {boolean} 如果 `object` 匹配,返回 `true`,否则返回 `false`。
22
22
  * @example
23
23
  *
24
24
  * const object = { a: 1, b: -0 }
package/types/isNaN.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * 检查值是否为 `NaN` 。
2
+ * 检查值是否为 `NaN`。
3
3
  *
4
4
  * 和 `Number.isNaN` 区别是 `new Number(NaN)` 也被认为是 `NaN`。
5
5
  *
@@ -7,7 +7,7 @@
7
7
  * @alias module:Language.isNaN
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为 `NaN` ,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为 `NaN`,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isNaN(NaN); // true
package/types/isNil.d.ts CHANGED
@@ -1,11 +1,11 @@
1
1
  /**
2
- * 检查值是否为 `undefined` 或 `null` 。
2
+ * 检查值是否为 `undefined` 或 `null`。
3
3
  *
4
4
  * @static
5
5
  * @alias module:Language.isNil
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `undefined` 或 `null` ,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `undefined` 或 `null`,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isNil(undefined); // true
package/types/isNull.d.ts CHANGED
@@ -1,11 +1,11 @@
1
1
  /**
2
- * 检查值是否为 `null` 。
2
+ * 检查值是否为 `null`。
3
3
  *
4
4
  * @static
5
5
  * @alias module:Language.isNull
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `null` ,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `null`,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isNull(null); // true
@@ -7,7 +7,7 @@
7
7
  * @alias module:Language.isNumber
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为数字类型或对象,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为数字类型或对象,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isNumber(1); // true
@@ -7,7 +7,7 @@ import { FunctionAny } from './internals/types';
7
7
  * @since 1.0.0
8
8
  * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types language type}
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为对象,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为对象,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isObject({}); // true
@@ -7,7 +7,7 @@
7
7
  * @alias module:Language.isObjectLike
8
8
  * @since 1.0.0
9
9
  * @param {*} value 要检查的值。
10
- * @returns {boolean} 如果值为类对象,返回 `true` ,否则返回 `false` 。
10
+ * @returns {boolean} 如果值为类对象,返回 `true`,否则返回 `false`。
11
11
  * @example
12
12
  *
13
13
  * isObjectLike({}); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isPlainObject
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为普通对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为普通对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * function Foo(){
@@ -12,7 +12,7 @@ type PromiseLikeObject = {
12
12
  * @alias module:Language.isPromiseLike
13
13
  * @since 1.0.0
14
14
  * @param {*} value 要检查的值。
15
- * @returns {boolean} 如果值类似 `Promise` 对象,返回 `true` ,否则返回 `false` 。
15
+ * @returns {boolean} 如果值类似 `Promise` 对象,返回 `true`,否则返回 `false`。
16
16
  * @example
17
17
  *
18
18
  * isPromiseLike(Promise.resolve()); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isRegExp
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值
8
- * @returns {boolean} 如果值为 `RegExp` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `RegExp` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isRegExp(/abc/); // true
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 检查值是否为安全整数。
3
3
  *
4
- * 同 `Number.isSafeInteger` 。
4
+ * 同 `Number.isSafeInteger`。
5
5
  *
6
6
  * 如果一个整数是一个 `IEEE-754` 双精度数字,它不是四舍五入的不安全整数的结果,那么它就是安全的。安全整数范围为 `-(2^53 - 1)` 到 `2^53 - 1` 之间的整数,包含 `-(2^53 - 1)` 和 `2^53 - 1`。
7
7
  *
@@ -9,7 +9,7 @@
9
9
  * @alias module:Language.isSafeInteger
10
10
  * @since 1.0.0
11
11
  * @param {*} value 要检查的值。
12
- * @returns {boolean} 如果值为安全整数,返回 `true` ,否则返回 `false` 。
12
+ * @returns {boolean} 如果值为安全整数,返回 `true`,否则返回 `false`。
13
13
  * @example
14
14
  *
15
15
  * isSafeInteger(1); // true
package/types/isSet.d.ts CHANGED
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isSet
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `Set` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `Set` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isSet(new Set); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isString
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为字符串类型或对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为字符串类型或对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isString('abc'); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isSymbol
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `Symbol` 类型或对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `Symbol` 类型或对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isSymbol(Symbol()); // true
@@ -6,7 +6,7 @@
6
6
  * @since 1.0.0
7
7
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays Typed_arrays}
8
8
  * @param {*} value 要检查的值。
9
- * @returns {boolean} 如果值为类型化数组,返回 `true` ,否则返回 `false` 。
9
+ * @returns {boolean} 如果值为类型化数组,返回 `true`,否则返回 `false`。
10
10
  * @example
11
11
  *
12
12
  * isTypedArray(new Uint8Array); // true
@@ -1,11 +1,11 @@
1
1
  /**
2
- * 检查值是否为 `undefined` 。
2
+ * 检查值是否为 `undefined`。
3
3
  *
4
4
  * @static
5
5
  * @alias module:Language.isUndefined
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `undefined` ,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `undefined`,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isUndefined(undefined); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isWeakMap
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `WeakMap` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `WeakMap` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isWeakMap(new WeakMap); // true
@@ -5,7 +5,7 @@
5
5
  * @alias module:Language.isWeakSet
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要检查的值。
8
- * @returns {boolean} 如果值为 `WeakSet` 对象,返回 `true` ,否则返回 `false` 。
8
+ * @returns {boolean} 如果值为 `WeakSet` 对象,返回 `true`,否则返回 `false`。
9
9
  * @example
10
10
  *
11
11
  * isWeakSet(new WeakSet); // true
package/types/keyBy.d.ts CHANGED
@@ -8,13 +8,13 @@ interface KeyBy {
8
8
  /**
9
9
  * 创建一个组成聚合对象, `key` 是经过 `iteratee` 执行处理 `collection` 中每个元素后返回的结果。每个 `key` 对应的值是生成 `key` 的最后一个元素。
10
10
  *
11
- * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection` 。
11
+ * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection`。
12
12
  *
13
13
  * @function
14
14
  * @alias module:Collection.keyBy
15
15
  * @since 1.0.0
16
16
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
17
- * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数,用来转换键。
17
+ * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数,用来转换键。默认 `identity`。
18
18
  * @returns {Object} 组成聚合对象。
19
19
  * @example
20
20
  *
package/types/keys.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 创建一个数组,包含对象自身的可枚举属性(不包含 `Symbol` 属性)。
3
3
  *
4
- * 同 `Object.keys` 。
4
+ * 同 `Object.keys`。
5
5
  *
6
6
  * @static
7
7
  * @alias module:Object.keys
package/types/keysIn.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 创建一个数组,包含对象自身及继承的可枚举属性(不包含 `Symbol` 属性)。
3
3
  *
4
- * 同 `key...in` 。
4
+ * 同 `key...in`。
5
5
  *
6
6
  * @static
7
7
  * @alias module:Object.keysIn
package/types/lt.d.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
- * 检查 `value` 是否小于 `other` 。
2
+ * 检查 `value` 是否小于 `other`。
3
3
  *
4
4
  * @function
5
5
  * @alias module:Util.lt
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要比较的值。
8
8
  * @param {*} other 另一个要比较的值。
9
- * @returns {boolean} 如果 `value` 小于 `other` 返回 `true` ,否则返回 `false` 。
9
+ * @returns {boolean} 如果 `value` 小于 `other` 返回 `true`,否则返回 `false`。
10
10
  * @example
11
11
  *
12
12
  * lt(1, 3); // true
package/types/lte.d.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
- * 检查 `value` 是否小于或等于 `other` 。
2
+ * 检查 `value` 是否小于或等于 `other`。
3
3
  *
4
4
  * @function
5
5
  * @alias module:Util.lte
6
6
  * @since 1.0.0
7
7
  * @param {*} value 要比较的值。
8
8
  * @param {*} other 另一个要比较的值。
9
- * @returns {boolean} 如果 `value` 小于或等于 `other` 返回 `true` ,否则返回 `false` 。
9
+ * @returns {boolean} 如果 `value` 小于或等于 `other` 返回 `true`,否则返回 `false`。
10
10
  * @example
11
11
  *
12
12
  * lte(1, 3); // true
package/types/map.d.ts CHANGED
@@ -8,13 +8,13 @@ interface Map {
8
8
  /**
9
9
  * 创建一个新数组,这个数组的值由迭代集合每个元素调用 `iteratee` 函数的返回值组成。
10
10
  *
11
- * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection` 。
11
+ * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection`。
12
12
  *
13
13
  * @static
14
14
  * @alias module:Collection.map
15
15
  * @since 1.7.0
16
16
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
17
- * @param {function} [iteratee=identity] 每次迭代调用的函数。
17
+ * @param {function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
18
18
  * @returns {Array} 一个新数组。
19
19
  * @example
20
20
  *
package/types/max.d.ts CHANGED
@@ -2,7 +2,7 @@ import { ExtremumFunction } from './internals/types';
2
2
  /**
3
3
  * 调用 `array` 中的每一个元素,来生成其值排序的标准,返回最大的值。
4
4
  *
5
- * `iteratee` 调用时会传入三个参数 `value` `index` `array` 。
5
+ * `iteratee` 调用时会传入三个参数 `value` `index` `array`。
6
6
  *
7
7
  * @function
8
8
  * @alias module:Math.max
package/types/merge.d.ts CHANGED
@@ -5,15 +5,15 @@ type Customizer = (objValue: any, srcValue: any, key: string | symbol, object: a
5
5
  *
6
6
  * 如果目标值存在,被解析为 `undefined` 的 `source` 来源对象属性将被跳过。数组和普通对象会递归合并,其他对象和值会被直接分配覆盖。
7
7
  *
8
- * 如果你需要合并继承的属性,第四个参数传入 {@link https://caijf.github.io/ut2/module-Object.html#.allKeysIn allKeysIn} 方法, `merge(object, source, undefined, allKeysIn)` 。
8
+ * 如果你需要合并继承的属性,第四个参数传入 {@link https://caijf.github.io/ut2/module-Object.html#.allKeysIn allKeysIn} 方法, `merge(object, source, undefined, allKeysIn)`。
9
9
  *
10
10
  * @static
11
11
  * @alias module:Object.merge
12
12
  * @since 1.0.0
13
13
  * @param {Object | Array} object 目标对象。
14
14
  * @param {Object | Array} source 来源对象。
15
- * @param {Function} [customizer] 自定义赋值函数。
16
- * @param {Function} [getKeys=allKeys] 自定义获取对象键方法。
15
+ * @param {Function} [customizer] 自定义赋值函数,如果函数返回 `undefined` 将使用默认合并。
16
+ * @param {Function} [getKeys=allKeys] 自定义获取对象键方法。默认 `allKeys`。
17
17
  * @returns {Object} 目标对象。
18
18
  * @example
19
19
  *
@@ -28,7 +28,7 @@ type Customizer = (objValue: any, srcValue: any, key: string | symbol, object: a
28
28
  * merge(object, other); // { a: [{b: 2, c: 3}, {d: 4, e: 5}] }
29
29
  *
30
30
  * // 自定义,数组不合并
31
- * merge(object, other, (objValue, srcValue) => Array.isArray(srcValue) ? srcValue : undefined); // { a: [{c: 3},{e: 5}] }
31
+ * merge(object, other, (objValue, srcValue) => isArray(srcValue) ? srcValue : undefined); // { a: [{c: 3},{e: 5}] }
32
32
  */
33
33
  declare function merge<TObject, TSource>(object: TObject, source: TSource, customizer?: Customizer, getKeys?: GetKeysMethod): TObject & TSource;
34
34
  export default merge;
package/types/min.d.ts CHANGED
@@ -2,7 +2,7 @@ import { ExtremumFunction } from './internals/types';
2
2
  /**
3
3
  * 调用 `array` 中的每一个元素,来生成其值排序的标准,返回最小的值。
4
4
  *
5
- * `iteratee` 调用时会传入三个参数 `value` `index` `array` 。
5
+ * `iteratee` 调用时会传入三个参数 `value` `index` `array`。
6
6
  *
7
7
  * @static
8
8
  * @alias module:Math.min
package/types/noop.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * 空函数,返回 `undefined` 。
2
+ * 空函数,返回 `undefined`。
3
3
  *
4
4
  * @static
5
5
  * @alias module:Util.noop
package/types/nth.d.ts CHANGED
@@ -7,7 +7,7 @@
7
7
  * @alias module:Array.nth
8
8
  * @since 1.0.0
9
9
  * @param {Array} array 要查询的数组。
10
- * @param {number} [n=0] 要返回元素的索引值。
10
+ * @param {number} [n=0] 要返回元素的索引值。默认 `0`。
11
11
  * @returns {*} 数组的第 `n` 个元素。
12
12
  * @example
13
13
  *
package/types/nthArg.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * @static
5
5
  * @alias module:Util.nthArg
6
6
  * @since 1.0.0
7
- * @param {number} [n=0] 要返回参数的索引值。
7
+ * @param {number} [n=0] 要返回参数的索引值。默认 `0`。
8
8
  * @returns 新函数。
9
9
  * @example
10
10
  *
package/types/omitBy.d.ts CHANGED
@@ -2,13 +2,14 @@ import { ObjectPredicate, WithNullable } from './internals/types';
2
2
  /**
3
3
  * 创建一个对象,该对象忽略 `predicate` (断言函数)判断不是真值的属性后,`object` 自身和继承的可枚举属性组成。与 [`pickBy`](#.pickBy) 相反。
4
4
  *
5
- * `predicate` 调用时会传入两个参数 `value` `key` 。
5
+ * `predicate` 调用时会传入两个参数 `value` `key`。
6
6
  *
7
7
  * @static
8
8
  * @alias module:Object.omitBy
9
9
  * @since 1.0.0
10
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
10
11
  * @param {Object} object 来源对象。
11
- * @param {Function} [predicate] 调用每一个属性的函数,返回 `truthy` 表示要忽略该属性,否则不忽略。
12
+ * @param {Function} [predicate] 调用每一个属性的函数,返回 `Truthy` 表示要忽略该属性,否则不忽略。
12
13
  * @returns {Object} 新对象。
13
14
  * @example
14
15
  *
@@ -11,7 +11,7 @@ interface OrderBy {
11
11
  *
12
12
  * `asc` 升序, `desc` 降序,默认执行稳定排序,也就是说相同元素会保持原始排序。
13
13
  *
14
- * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection` 。
14
+ * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection`。
15
15
  *
16
16
  * @function
17
17
  * @alias module:Collection.orderBy
@@ -37,7 +37,7 @@ interface Partial {
37
37
  _: Placeholder;
38
38
  }
39
39
  /**
40
- * 创建一个函数。该函数调用 `func` ,并传入预设的 `args` 参数。
40
+ * 创建一个函数。该函数调用 `func`,并传入预设的 `args` 参数。
41
41
  *
42
42
  * `partial._` 或 `partial.placeholder` 可用作参数的占位符。
43
43
  *
@@ -6,15 +6,17 @@ interface Partition {
6
6
  <T extends object, V extends T[keyof T]>(collection: CollectionObject<T>, iteratee?: PropertyName): [V[], V[]];
7
7
  }
8
8
  /**
9
- * 创建一个分成两组的元素数组,第一组包含 `predicate`(断言函数)返回为 [`truthy`](https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy)(真值)的元素,第二组包含 `predicate`(断言函数)返回为 [`falsy`](https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy)(假值)的元素。
9
+ * 创建一个分成两组的元素数组,第一组包含 `predicate`(断言函数)返回为 [`Truthy`](https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy)(真值)的元素,第二组包含 `predicate`(断言函数)返回为 [`Falsy`](https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy)(假值)的元素。
10
10
  *
11
- * `predicate` 调用时会传入三个参数 `value` `index|key` `collection` 。
11
+ * `predicate` 调用时会传入三个参数 `value` `index|key` `collection`。
12
12
  *
13
13
  * @static
14
14
  * @alias module:Collection.partition
15
15
  * @since 1.0.0
16
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
17
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy Falsy}
16
18
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
17
- * @param {Function | string | number | Symbol | Array} [predicate=identity] 每次迭代调用的断言函数。
19
+ * @param {Function | string | number | Symbol | Array} [predicate=identity] 每次迭代调用的断言函数。默认 `identity`。
18
20
  * @returns {Array} 分组后的数组。
19
21
  * @example
20
22
  *
package/types/pickBy.d.ts CHANGED
@@ -2,13 +2,14 @@ import { ObjectPredicate, WithNullable } from './internals/types';
2
2
  /**
3
3
  * 创建一个对象,该对象的属性从 `object` 中经 `predicate` (断言函数)判断为真值的属性。
4
4
  *
5
- * `predicate` 调用时会传入两个参数 `value` `key` 。
5
+ * `predicate` 调用时会传入两个参数 `value` `key`。
6
6
  *
7
7
  * @static
8
8
  * @alias module:Object.pickBy
9
9
  * @since 1.0.0
10
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
10
11
  * @param {Object} obj 来源对象。
11
- * @param {Function} [predicate] 调用每一个属性的函数,返回 `truthy` 表示要提取该属性,否则不提取。
12
+ * @param {Function} [predicate] 调用每一个属性的函数,返回 `Truthy` 表示要提取该属性,否则不提取。
12
13
  * @returns {Object} 新对象。
13
14
  * @example
14
15
  *
package/types/random.d.ts CHANGED
@@ -6,8 +6,8 @@
6
6
  * @static
7
7
  * @alias module:Number.random
8
8
  * @since 1.0.0
9
- * @param {number} [lower=0] 下限,默认 0
10
- * @param {number} [upper=1] 上限,默认 1
9
+ * @param {number} [lower=0] 下限。默认 `0`。
10
+ * @param {number} [upper=1] 上限。默认 `1`。
11
11
  * @returns {number} 随机浮点数。
12
12
  * @example
13
13
  *