ut2 1.1.3 → 1.2.0

package/types/union.d.ts

@@ -1,14 +1,17 @@
 /**
- * 创建一个按顺序排列的唯一值的数组（并集）。使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。与 [`uniq`](#.uniq) 相似。
+ * 创建一个按顺序排列的唯一值的数组（并集）。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。与 [`uniq`](#.uniq) 相似。
  *
  * `iteratee` 调用时会传入 1 个参数 `value` 。
  *
+ * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
+ *
  * @static
  * @alias module:Array.union
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {Array} 新的联合数组。
  * @example
  *
@@ -16,11 +19,15 @@
  *
  * union([2.1], [1.2, 2.3], Math.floor); // [2.1, 1.2]
  *
- * intersection([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], item=>item.x); // [{x: 1}, {x: 2}]
+ * union([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], item=>item.x); // [{x: 1}, {x: 2}]
  *
  * // 迭代函数可以直接写入属性。
- * intersection([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], 'x'); // [{x: 1}, {x: 2}]
+ * union([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], 'x'); // [{x: 1}, {x: 2}]
+ *
+ * union([-0, 0], [-0]); // [-0]
+ *
+ * union([-0, 0], [-0], undefined, true); // [-0, 0]
  *
  */
-declare function union<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K): T[];
+declare function union<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K, strickCheck?: boolean): T[];
 export default union;

package/types/uniq.d.ts

@@ -1,13 +1,16 @@
 /**
- * 创建一个去重后的数组副本。使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。只有第一次出现的元素才会被保留。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
+ * 创建一个去重后的数组副本。只有第一次出现的元素才会被保留。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
  * `iteratee` 调用时会传入 1 个参数 `value` 。
  *
+ * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
+ *
  * @static
  * @alias module:Array.uniq
  * @since 1.0.0
  * @param {Array}  array 要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {Array} 去重后的新数组。
  * @example
  *
@@ -20,6 +23,10 @@
  * // 迭代函数可以直接写入属性。
  * uniq([{x: 1}, {x: 2}, {x: 1}], 'x'); // [{x: 1}, {x: 2}]
  *
+ * uniq([-0, 0]); // [-0]
+ *
+ * uniq([-0, 0], undefined, true); // [-0, 0]
+ *
  */
-declare function uniq<T, F extends (value: T) => any, K extends keyof T>(array: T[], iteratee?: F | K): T[];
+declare function uniq<T, F extends (value: T) => any, K extends keyof T>(array: T[], iteratee?: F | K, strickCheck?: boolean): T[];
 export default uniq;

package/types/xor.d.ts

@@ -1,26 +1,33 @@
 /**
- * 创建一个唯一值的数组（并集-交集），该数组包含 2 个数组参数中不相同的元素。使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
+ * 创建一个唯一值的数组（并集-交集），该数组包含 2 个数组参数中不相同的元素。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
  * `iteratee` 调用时会传入 1 个参数 `value` 。
  *
+ * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
+ *
  * @static
  * @alias module:Array.xor
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {Array} 过滤值后的新数组。
  * @example
  *
- * intersection([2, 1, 1], [4, 2]); // [1, 4]
+ * xor([2, 1, 1], [4, 2]); // [1, 4]
  *
- * intersection([2.1, 1.2], [4.3, 2.4], Math.floor); // [1.2, 4.3]
+ * xor([2.1, 1.2], [4.3, 2.4], Math.floor); // [1.2, 4.3]
  *
- * intersection([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], item=>item.x); // [{x: 2}]
+ * xor([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], item=>item.x); // [{x: 2}]
  *
  * // 迭代函数可以直接写入属性。
- * intersection([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], 'x'); // [{x: 2}]
+ * xor([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], 'x'); // [{x: 2}]
+ *
+ * xor([-0, 0],[0]); // []
+ *
+ * xor([-0, 0],[0], undefined, true); // [-0]
  *
  */
-declare function xor<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K): T[];
+declare function xor<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K, strickCheck?: boolean): T[];
 export default xor;