ut2 1.1.3 → 1.2.0

package/es/difference.js

@@ -2,7 +2,8 @@ import eq from './eq.js';
 import createIteratee from './internals/createIteratee.js';
 import isArray from './isArray.js';
 
-function difference(array, values, iteratee) {
+function difference(array, values, iteratee, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
     if (!isArray(array)) {
         return [];
     }
@@ -12,7 +13,7 @@ function difference(array, values, iteratee) {
     var internalIteratee = createIteratee(iteratee);
     return array.filter(function (item) {
         var current = internalIteratee(item);
-        return values.findIndex(function (value) { return eq(internalIteratee(value), current); }) === -1;
+        return values.findIndex(function (value) { return eq(internalIteratee(value), current, strictCheck); }) === -1;
     });
 }
 

package/es/eq.js

@@ -1,4 +1,8 @@
-function eq(value, other) {
+function eq(value, other, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
+    if (strictCheck) {
+        return Object.is(value, other);
+    }
     return value === other || (value !== value && other !== other);
 }
 

package/es/index.js

@@ -20,6 +20,7 @@ export { default as before } from './before.js';
 export { default as debounce } from './debounce.js';
 export { default as delay } from './delay.js';
 export { default as negate } from './negate.js';
+export { default as once } from './once.js';
 export { default as partial } from './partial.js';
 export { default as throttle } from './throttle.js';
 export { default as ceil } from './ceil.js';
@@ -59,6 +60,7 @@ export { default as isArrayLikeObject } from './isArrayLikeObject.js';
 export { default as isBlob } from './isBlob.js';
 export { default as isBoolean } from './isBoolean.js';
 export { default as isBuffer } from './isBuffer.js';
+export { default as isDataView } from './isDataView.js';
 export { default as isDate } from './isDate.js';
 export { default as isElement } from './isElement.js';
 export { default as isEmpty } from './isEmpty.js';

package/es/internals/helpers.js

@@ -8,6 +8,6 @@ var numberIsInteger = Number.isInteger;
 var numberIsSafeInteger = Number.isSafeInteger;
 var objectGetOwnPropertySymbols = Object.getOwnPropertySymbols;
 var arrayAt = Array.prototype.at;
-var VERSION = "1.1.3";
+var VERSION = "1.2.0";
 
 export { FUNC_ERROR_TEXT, VERSION, argType, arrayAt, numberIsFinite, numberIsInteger, numberIsSafeInteger, objectGetOwnPropertySymbols, supportedArgumentsType };

package/es/intersection.js

@@ -2,7 +2,8 @@ import eq from './eq.js';
 import createIteratee from './internals/createIteratee.js';
 import isArray from './isArray.js';
 
-function intersection(array, other, iteratee) {
+function intersection(array, other, iteratee, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
     if (!isArray(array) || !isArray(other)) {
         return [];
     }
@@ -10,8 +11,7 @@ function intersection(array, other, iteratee) {
     var caches = [];
     return array.filter(function (item) {
         var current = internalIteratee(item);
-        if (other.findIndex(function (value) { return eq(internalIteratee(value), current); }) !== -1 &&
-            !caches.includes(current)) {
+        if (other.findIndex(function (value) { return eq(internalIteratee(value), current, strictCheck); }) !== -1 && !caches.includes(current)) {
             caches.push(current);
             return true;
         }

package/es/isDataView.js

@@ -0,0 +1,7 @@
+import isType from './internals/isType.js';
+
+function isDataView(value) {
+    return isType(value, 'DataView');
+}
+
+export { isDataView as default };

package/es/isPlainObject.js

@@ -11,9 +11,7 @@ function isPlainObject(value) {
         return true;
     }
     var Ctor = hasOwnProperty.call(proto, 'constructor') && proto.constructor;
-    return (typeof Ctor === 'function' &&
-        Ctor instanceof Ctor &&
-        functionToString.call(Ctor) === objectCtorString);
+    return typeof Ctor === 'function' && Ctor instanceof Ctor && functionToString.call(Ctor) === objectCtorString;
 }
 
 export { isPlainObject as default };

package/es/once.js

@@ -0,0 +1,7 @@
+import before from './before.js';
+
+function once(func) {
+    return before(2, func);
+}
+
+export { once as default };

package/es/union.js

@@ -1,11 +1,12 @@
 import isArray from './isArray.js';
 import uniq from './uniq.js';
 
-function union(array, other, iteratee) {
+function union(array, other, iteratee, strickCheck) {
     if (other === void 0) { other = []; }
+    if (strickCheck === void 0) { strickCheck = false; }
     array = isArray(array) ? array : [];
     other = isArray(other) ? other : [];
-    return uniq(array.concat(other), iteratee);
+    return uniq(array.concat(other), iteratee, strickCheck);
 }
 
 export { union as default };

package/es/uniq.js

@@ -2,14 +2,15 @@ import eq from './eq.js';
 import createIteratee from './internals/createIteratee.js';
 import isArray from './isArray.js';
 
-function uniq(array, iteratee) {
+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); }) === index;
+        return arr.findIndex(function (item) { return eq(internalIteratee(item), current, strickCheck); }) === index;
     });
 }
 

package/es/xor.js

@@ -5,19 +5,20 @@ import isArray from './isArray.js';
 import union from './union.js';
 import uniq from './uniq.js';
 
-function xor(array, other, iteratee) {
+function xor(array, other, iteratee, strickCheck) {
     if (other === void 0) { other = []; }
-    var internalIteratee = createIteratee(iteratee);
+    if (strickCheck === void 0) { strickCheck = false; }
     if (!isArray(array) && !isArray(other)) {
         return [];
     }
+    var internalIteratee = createIteratee(iteratee);
     if (!isArray(other)) {
-        return uniq(array, internalIteratee);
+        return uniq(array, internalIteratee, strickCheck);
     }
     if (!isArray(array)) {
-        return uniq(other, internalIteratee);
+        return uniq(other, internalIteratee, strickCheck);
     }
-    return difference(union(array, other, internalIteratee), intersection(array, other, internalIteratee), internalIteratee);
+    return difference(union(array, other, internalIteratee, strickCheck), intersection(array, other, internalIteratee, strickCheck), internalIteratee, strickCheck);
 }
 
 export { xor as default };

package/lib/difference.js

@@ -4,7 +4,8 @@ var eq = require('./eq.js');
 var createIteratee = require('./internals/createIteratee.js');
 var isArray = require('./isArray.js');
 
-function difference(array, values, iteratee) {
+function difference(array, values, iteratee, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
     if (!isArray(array)) {
         return [];
     }
@@ -14,7 +15,7 @@ function difference(array, values, iteratee) {
     var internalIteratee = createIteratee(iteratee);
     return array.filter(function (item) {
         var current = internalIteratee(item);
-        return values.findIndex(function (value) { return eq(internalIteratee(value), current); }) === -1;
+        return values.findIndex(function (value) { return eq(internalIteratee(value), current, strictCheck); }) === -1;
     });
 }
 

package/lib/eq.js

@@ -1,6 +1,10 @@
 'use strict';
 
-function eq(value, other) {
+function eq(value, other, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
+    if (strictCheck) {
+        return Object.is(value, other);
+    }
     return value === other || (value !== value && other !== other);
 }
 

package/lib/index.js

@@ -22,6 +22,7 @@ var before = require('./before.js');
 var debounce = require('./debounce.js');
 var delay = require('./delay.js');
 var negate = require('./negate.js');
+var once = require('./once.js');
 var partial = require('./partial.js');
 var throttle = require('./throttle.js');
 var ceil = require('./ceil.js');
@@ -61,6 +62,7 @@ var isArrayLikeObject = require('./isArrayLikeObject.js');
 var isBlob = require('./isBlob.js');
 var isBoolean = require('./isBoolean.js');
 var isBuffer = require('./isBuffer.js');
+var isDataView = require('./isDataView.js');
 var isDate = require('./isDate.js');
 var isElement = require('./isElement.js');
 var isEmpty = require('./isEmpty.js');
@@ -136,6 +138,7 @@ exports.before = before;
 exports.debounce = debounce;
 exports.delay = delay;
 exports.negate = negate;
+exports.once = once;
 exports.partial = partial;
 exports.throttle = throttle;
 exports.ceil = ceil;
@@ -175,6 +178,7 @@ exports.isArrayLikeObject = isArrayLikeObject;
 exports.isBlob = isBlob;
 exports.isBoolean = isBoolean;
 exports.isBuffer = isBuffer;
+exports.isDataView = isDataView;
 exports.isDate = isDate;
 exports.isElement = isElement;
 exports.isEmpty = isEmpty;

package/lib/internals/helpers.js

@@ -10,4 +10,4 @@ exports.numberIsInteger = Number.isInteger;
 exports.numberIsSafeInteger = Number.isSafeInteger;
 exports.objectGetOwnPropertySymbols = Object.getOwnPropertySymbols;
 exports.arrayAt = Array.prototype.at;
-exports.VERSION = "1.1.3";
+exports.VERSION = "1.2.0";

package/lib/intersection.js

@@ -4,7 +4,8 @@ var eq = require('./eq.js');
 var createIteratee = require('./internals/createIteratee.js');
 var isArray = require('./isArray.js');
 
-function intersection(array, other, iteratee) {
+function intersection(array, other, iteratee, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = false; }
     if (!isArray(array) || !isArray(other)) {
         return [];
     }
@@ -12,8 +13,7 @@ function intersection(array, other, iteratee) {
     var caches = [];
     return array.filter(function (item) {
         var current = internalIteratee(item);
-        if (other.findIndex(function (value) { return eq(internalIteratee(value), current); }) !== -1 &&
-            !caches.includes(current)) {
+        if (other.findIndex(function (value) { return eq(internalIteratee(value), current, strictCheck); }) !== -1 && !caches.includes(current)) {
             caches.push(current);
             return true;
         }

package/lib/isDataView.js

@@ -0,0 +1,9 @@
+'use strict';
+
+var isType = require('./internals/isType.js');
+
+function isDataView(value) {
+    return isType(value, 'DataView');
+}
+
+module.exports = isDataView;

package/lib/isPlainObject.js

@@ -13,9 +13,7 @@ function isPlainObject(value) {
         return true;
     }
     var Ctor = native.hasOwnProperty.call(proto, 'constructor') && proto.constructor;
-    return (typeof Ctor === 'function' &&
-        Ctor instanceof Ctor &&
-        native.functionToString.call(Ctor) === native.objectCtorString);
+    return typeof Ctor === 'function' && Ctor instanceof Ctor && native.functionToString.call(Ctor) === native.objectCtorString;
 }
 
 module.exports = isPlainObject;

package/lib/once.js

@@ -0,0 +1,9 @@
+'use strict';
+
+var before = require('./before.js');
+
+function once(func) {
+    return before(2, func);
+}
+
+module.exports = once;

package/lib/union.js

@@ -3,11 +3,12 @@
 var isArray = require('./isArray.js');
 var uniq = require('./uniq.js');
 
-function union(array, other, iteratee) {
+function union(array, other, iteratee, strickCheck) {
     if (other === void 0) { other = []; }
+    if (strickCheck === void 0) { strickCheck = false; }
     array = isArray(array) ? array : [];
     other = isArray(other) ? other : [];
-    return uniq(array.concat(other), iteratee);
+    return uniq(array.concat(other), iteratee, strickCheck);
 }
 
 module.exports = union;

package/lib/uniq.js

@@ -4,14 +4,15 @@ var eq = require('./eq.js');
 var createIteratee = require('./internals/createIteratee.js');
 var isArray = require('./isArray.js');
 
-function uniq(array, iteratee) {
+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); }) === index;
+        return arr.findIndex(function (item) { return eq(internalIteratee(item), current, strickCheck); }) === index;
     });
 }
 

package/lib/xor.js

@@ -7,19 +7,20 @@ var isArray = require('./isArray.js');
 var union = require('./union.js');
 var uniq = require('./uniq.js');
 
-function xor(array, other, iteratee) {
+function xor(array, other, iteratee, strickCheck) {
     if (other === void 0) { other = []; }
-    var internalIteratee = createIteratee(iteratee);
+    if (strickCheck === void 0) { strickCheck = false; }
     if (!isArray(array) && !isArray(other)) {
         return [];
     }
+    var internalIteratee = createIteratee(iteratee);
     if (!isArray(other)) {
-        return uniq(array, internalIteratee);
+        return uniq(array, internalIteratee, strickCheck);
     }
     if (!isArray(array)) {
-        return uniq(other, internalIteratee);
+        return uniq(other, internalIteratee, strickCheck);
     }
-    return difference(union(array, other, internalIteratee), intersection(array, other, internalIteratee), internalIteratee);
+    return difference(union(array, other, internalIteratee, strickCheck), intersection(array, other, internalIteratee, strickCheck), internalIteratee, strickCheck);
 }
 
 module.exports = xor;

package/package.json

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

package/types/before.d.ts

@@ -16,16 +16,9 @@
  * });
  *
  * increment(); // 1
- *
  * increment(); // 2
- *
  * increment(); // 2 返回之前的结果
  *
- * // 只执行一次
- * const once = function (func){
- *   before(2, func);
- * }
- *
  */
 declare function before<T extends (...args: any[]) => any>(n: number, func: T): T;
 export default before;

package/types/difference.d.ts

@@ -1,14 +1,17 @@
 /**
- * 创建一个 `array` 排除 `values` 值的新数组。使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
+ * 创建一个 `array` 排除 `values` 值的新数组。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
  * `iteratee` 调用时会传入 1 个参数 `value` 。
  *
+ * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
+ *
  * @static
  * @alias module:Array.difference
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} values 排除的值。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {Array} 过滤值后的新数组。
  * @example
  *
@@ -21,6 +24,10 @@
  * // 如果迭代元素为对象，迭代函数可以直接写入对象属性。
  * difference([{x: 2}, {x: 1}], [{x: 1}], 'x'); // [{x: 2}]
  *
+ * difference([-0, 0], [0]); // []
+ *
+ * difference([-0, 0], [0], undefined, true); // [-0]
+ *
  */
-declare function difference<T, F extends (value: T) => any, K extends keyof T>(array: T[], values: any[], iteratee?: F | K): T[];
+declare function difference<T, F extends (value: T) => any, K extends keyof T>(array: T[], values: any[], iteratee?: F | K, strictCheck?: boolean): T[];
 export default difference;

package/types/eq.d.ts

@@ -1,11 +1,15 @@
 /**
- * 检查两个值是否相等。使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。
+ * 检查两个值是否相等。
+ *
+ * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
  *
  * @static
  * @alias module:Util.eq
  * @since 1.0.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness | JavaScript 中的相等性判断}
  * @param {*} value 要比较的值。
  * @param {*} other 另一个要比较的值。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {boolean} 如果两个值相等，返回 `true` ，否则返回 `false` 。
  * @example
  *
@@ -23,6 +27,8 @@
  *
  * eq(object, object); // true
  *
+ * eq(-0, 0, true); // false
+ *
  */
-declare function eq(value: any, other: any): boolean;
+declare function eq(value: any, other: any, strictCheck?: boolean): boolean;
 export default eq;

package/types/index.d.ts

@@ -38,6 +38,7 @@ export { default as before } from './before';
 export { default as debounce } from './debounce';
 export { default as delay } from './delay';
 export { default as negate } from './negate';
+export { default as once } from './once';
 export { default as partial } from './partial';
 export { default as throttle } from './throttle';
 /**
@@ -107,6 +108,7 @@ export { default as isArrayLikeObject } from './isArrayLikeObject';
 export { default as isBlob } from './isBlob';
 export { default as isBoolean } from './isBoolean';
 export { default as isBuffer } from './isBuffer';
+export { default as isDataView } from './isDataView';
 export { default as isDate } from './isDate';
 export { default as isElement } from './isElement';
 export { default as isEmpty } from './isEmpty';

package/types/intersection.d.ts

@@ -1,14 +1,17 @@
 /**
- * 创建唯一值的数组，该数组包含 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.intersection
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} other 另一个要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
  * @returns {Array} 包含所有传入数组交集元素的新数组。
  * @example
  *
@@ -21,6 +24,10 @@
  * // 迭代函数可以直接写入属性。
  * intersection([{x: 1}, {x: 1}, {x: 2}, {x: 2}], [{x: 1}], 'x'); // [{x: 1}]
  *
+ * intersection([-0, 0], [0]); // [-0]
+ *
+ * intersection([-0, 0], [0], undefined, true); // [0]
+ *
  */
-declare function intersection<T, F extends (value: T) => any, K extends keyof T>(array: T[], other: T[], iteratee?: F | K): T[];
+declare function intersection<T, F extends (value: T) => any, K extends keyof T>(array: T[], other: T[], iteratee?: F | K, strictCheck?: boolean): T[];
 export default intersection;

package/types/isArrayLikeObject.d.ts

@@ -8,13 +8,13 @@
  * @returns {boolean} 如果值为类数组对象，返回 `true` ，否则返回 `false` 。
  * @example
  *
- * isArrayLike([1, 2, 3]); // true
+ * isArrayLikeObject([1, 2, 3]); // true
  *
- * isArrayLike(document.body.children); // true
+ * isArrayLikeObject(document.body.children); // true
  *
- * isArrayLike('abc'); // false
+ * isArrayLikeObject('abc'); // false
  *
- * isArrayLike(()=>{}); // false
+ * isArrayLikeObject(()=>{}); // false
  *
  */
 declare function isArrayLikeObject(value: any): boolean;

package/types/isBuffer.d.ts

@@ -11,7 +11,7 @@
  * @returns {boolean} 如果值为 `buffer` ，返回 `true` ，否则返回 `false` 。
  * @example
  *
- * isBuffer(new Blob(['a'])); // true
+ * isBuffer(new Buffer(2)); // true
  *
  * isBuffer({}); // false
  *

package/types/isDataView.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 检查值是否为 `DataView` 对象。
+ *
+ * @static
+ * @alias module:Type.isDataView
+ * @since 1.2.0
+ * @param {*} value 要检查的值。
+ * @returns {boolean} 如果值为 `DataView` 对象，返回 `true` ，否则返回 `false` 。
+ * @example
+ *
+ * isDataView(new DataView(new ArrayBuffer(8))); // true
+ *
+ */
+declare function isDataView(value: any): boolean;
+export default isDataView;

package/types/isPlainObject.d.ts

@@ -14,11 +14,11 @@
  *
  * isPlainObject(new Foo); // false
  *
- * isObject([1,2,3]); // false
+ * isPlainObject([1,2,3]); // false
  *
- * isObject({ a: 1, b: 2 }); // true
+ * isPlainObject({ a: 1, b: 2 }); // true
  *
- * isObject(Object.create(null)); // true
+ * isPlainObject(Object.create(null)); // true
  *
  */
 declare function isPlainObject(value: any): boolean;

package/types/isTypedArray.d.ts

@@ -9,9 +9,9 @@
  * @returns {boolean} 如果值为类型化数组，返回 `true` ，否则返回 `false` 。
  * @example
  *
- * ut2.isTypedArray(new Uint8Array); // true
+ * isTypedArray(new Uint8Array); // true
  *
- * ut2.isTypedArray([]); // false
+ * isTypedArray([]); // false
  *
  */
 declare function isTypedArray(value: any): boolean;

package/types/once.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 创建一个只能调用 `func` 一次的函数。重复调用将返回第一次调用 `func` 的结果。
+ *
+ * @static
+ * @alias module:Function.once
+ * @since 1.2.0
+ * @requires module:Function.before
+ * @param {Function} func 限制执行的函数。
+ * @returns {Function} 新的限定函数。
+ * @example
+ *
+ * let count = 0;
+ *
+ * const increment = _.once(()=>{
+ *   return ++count;
+ * });
+ *
+ * increment(); // 1
+ * increment(); // 1
+ * increment(); // 1
+ *
+ */
+declare function once<T extends (...args: any[]) => any>(func: T): T;
+export default once;

package/types/toFinite.d.ts

@@ -8,21 +8,21 @@
  * @returns {number} 转换后的数字。
  * @example
  *
- * toSafeInteger(3.2); // 3.2
+ * toFinite(3.2); // 3.2
  *
- * toSafeInteger('3.2'); // 3.2
+ * toFinite('3.2'); // 3.2
  *
- * toSafeInteger(-0); // -0
+ * toFinite(-0); // -0
  *
- * toSafeInteger('-0'); // -0
+ * toFinite('-0'); // -0
  *
- * toSafeInteger('0'); // 0
+ * toFinite('0'); // 0
  *
- * toSafeInteger(NaN); // 0
+ * toFinite(NaN); // 0
  *
- * toSafeInteger(Infinity); // 1.7976931348623157e+308
+ * toFinite(Infinity); // 1.7976931348623157e+308
  *
- * toSafeInteger(-Infinity); // -1.7976931348623157e+308
+ * toFinite(-Infinity); // -1.7976931348623157e+308
  *
  */
 declare function toFinite(value: any): number;