ut2 1.17.0 → 1.18.1

package/es/equalArrayLike.js

@@ -0,0 +1,19 @@
+import eq from './eq.js';
+import isArrayLike from './isArrayLike.js';
+
+function equalArrayLike(arg1, arg2, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = true; }
+    if (eq(arg1, arg2, strictCheck))
+        return true;
+    if (!isArrayLike(arg1) || !isArrayLike(arg2))
+        return false;
+    if (arg1.length !== arg2.length)
+        return false;
+    for (var i = 0; i < arg1.length; i++) {
+        if (!eq(arg1[i], arg2[i], strictCheck))
+            return false;
+    }
+    return true;
+}
+
+export { equalArrayLike as default };

package/es/index.js

@@ -30,6 +30,7 @@ export { default as before } from './before.js';
 export { default as curry } from './curry.js';
 export { default as debounce } from './debounce.js';
 export { default as delay } from './delay.js';
+export { default as limit } from './limit.js';
 export { default as memoize } from './memoize.js';
 export { default as negate } from './negate.js';
 export { default as once } from './once.js';
@@ -120,6 +121,7 @@ export { default as conformsTo } from './conformsTo.js';
 export { default as constant } from './constant.js';
 export { default as defaultTo } from './defaultTo.js';
 export { default as eq } from './eq.js';
+export { default as equalArrayLike } from './equalArrayLike.js';
 export { default as gt } from './gt.js';
 export { default as gte } from './gte.js';
 export { default as guard } from './guard.js';

package/es/internals/helpers.js

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

@@ -0,0 +1,21 @@
+import { __spreadArray, __read } from 'tslib';
+
+function limit(fn, timespan) {
+    var pending = false;
+    function limited() {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (pending)
+            return;
+        pending = true;
+        fn.apply(void 0, __spreadArray([], __read(args), false));
+        setTimeout(function () {
+            pending = false;
+        }, timespan);
+    }
+    return limited;
+}
+
+export { limit as default };

package/es/memoize.js

@@ -1,21 +1,10 @@
-import eq from './eq.js';
+import equalArrayLike from './equalArrayLike.js';
 import { mathCeil } from './internals/native.js';
 
-function argsEqual(newArgs, lastArgs) {
-    if (newArgs.length !== lastArgs.length) {
-        return false;
-    }
-    for (var i = 0, len = newArgs.length; i < len; i++) {
-        if (!eq(newArgs[i], lastArgs[i])) {
-            return false;
-        }
-    }
-    return true;
-}
 function memoize(func, options) {
     var opts = options || {};
     var max = mathCeil(opts.max || 0);
-    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : argsEqual;
+    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : equalArrayLike;
     var cache = [];
     function memoized() {
         var _this = this;

package/lib/equalArrayLike.js

@@ -0,0 +1,21 @@
+'use strict';
+
+var eq = require('./eq.js');
+var isArrayLike = require('./isArrayLike.js');
+
+function equalArrayLike(arg1, arg2, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = true; }
+    if (eq(arg1, arg2, strictCheck))
+        return true;
+    if (!isArrayLike(arg1) || !isArrayLike(arg2))
+        return false;
+    if (arg1.length !== arg2.length)
+        return false;
+    for (var i = 0; i < arg1.length; i++) {
+        if (!eq(arg1[i], arg2[i], strictCheck))
+            return false;
+    }
+    return true;
+}
+
+module.exports = equalArrayLike;

package/lib/index.js

@@ -32,6 +32,7 @@ var before = require('./before.js');
 var curry = require('./curry.js');
 var debounce = require('./debounce.js');
 var delay = require('./delay.js');
+var limit = require('./limit.js');
 var memoize = require('./memoize.js');
 var negate = require('./negate.js');
 var once = require('./once.js');
@@ -122,6 +123,7 @@ var conformsTo = require('./conformsTo.js');
 var constant = require('./constant.js');
 var defaultTo = require('./defaultTo.js');
 var eq = require('./eq.js');
+var equalArrayLike = require('./equalArrayLike.js');
 var gt = require('./gt.js');
 var gte = require('./gte.js');
 var guard = require('./guard.js');
@@ -182,6 +184,7 @@ exports.before = before;
 exports.curry = curry;
 exports.debounce = debounce;
 exports.delay = delay;
+exports.limit = limit;
 exports.memoize = memoize;
 exports.negate = negate;
 exports.once = once;
@@ -272,6 +275,7 @@ exports.conformsTo = conformsTo;
 exports.constant = constant;
 exports.defaultTo = defaultTo;
 exports.eq = eq;
+exports.equalArrayLike = equalArrayLike;
 exports.gt = gt;
 exports.gte = gte;
 exports.guard = guard;

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.17.0";
+var VERSION = "1.18.1";
 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/limit.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var tslib = require('tslib');
+
+function limit(fn, timespan) {
+    var pending = false;
+    function limited() {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (pending)
+            return;
+        pending = true;
+        fn.apply(void 0, tslib.__spreadArray([], tslib.__read(args), false));
+        setTimeout(function () {
+            pending = false;
+        }, timespan);
+    }
+    return limited;
+}
+
+module.exports = limit;

package/lib/memoize.js

@@ -1,23 +1,12 @@
 'use strict';
 
-var eq = require('./eq.js');
+var equalArrayLike = require('./equalArrayLike.js');
 var native = require('./internals/native.js');
 
-function argsEqual(newArgs, lastArgs) {
-    if (newArgs.length !== lastArgs.length) {
-        return false;
-    }
-    for (var i = 0, len = newArgs.length; i < len; i++) {
-        if (!eq(newArgs[i], lastArgs[i])) {
-            return false;
-        }
-    }
-    return true;
-}
 function memoize(func, options) {
     var opts = options || {};
     var max = native.mathCeil(opts.max || 0);
-    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : argsEqual;
+    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : equalArrayLike;
     var cache = [];
     function memoized() {
         var _this = this;

package/package.json

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

package/types/equalArrayLike.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 比较两个类数组的值是否相等。常用于参数对象比较。
+ *
+ * 1. 如果两个值相等，返回 `true`。
+ * 2. 如果两个类数组 `length` 相等，且遍历每个值都相等，则返回 `true`。
+ * 3. 否则返回 `false`。
+ *
+ * @alias module:Util.equalArrayLike
+ * @since 1.18.0
+ * @param {Array} arg1 类数组1。
+ * @param {Array} arg2 类数组2。
+ * @param {boolean} [strictCheck=true] 严格比较，如果为 `true` 表示区分 `0` 和 `-0`。默认 `true`。
+ * @returns 是否相等。
+ * @example
+ * equalArrayLike([1, 2], [1, 2]); // true
+ * equalArrayLike([1, 2], [1, 3]); // false
+ * equalArrayLike([1, 2], [1, 2, 3]); // false
+ *
+ * // 松散比较
+ * equalArrayLike(['a', 'b'], 'ab'); // true
+ * equalArrayLike(['a', 'b'], { 0: 'a', 1: 'b', length: 2 }); // true
+ *
+ * // 两个相等值返回 true
+ * equalArrayLike(NaN, NaN); // true
+ * equalArrayLike(null, null); // true
+ * equalArrayLike(undefined, undefined); // true
+ * const obj1 = {};
+ * const obj2 = obj1;
+ * equalArrayLike(obj1, obj2); // true
+ *
+ * // 0 和 -0 严格比较返回 false
+ * equalArrayLike([0, -0], [-0, 0]); // false
+ * // 非严格比较返回 true
+ * equalArrayLike([0, -0], [-0, 0], false); // true
+ */
+declare function equalArrayLike(arg1: ArrayLike<any>, arg2: ArrayLike<any>, strictCheck?: boolean): boolean;
+export default equalArrayLike;

package/types/index.d.ts

@@ -48,6 +48,7 @@ export { default as before } from './before';
 export { default as curry } from './curry';
 export { default as debounce } from './debounce';
 export { default as delay } from './delay';
+export { default as limit } from './limit';
 export { default as memoize } from './memoize';
 export { default as negate } from './negate';
 export { default as once } from './once';
@@ -174,6 +175,7 @@ export { default as conformsTo } from './conformsTo';
 export { default as constant } from './constant';
 export { default as defaultTo } from './defaultTo';
 export { default as eq } from './eq';
+export { default as equalArrayLike } from './equalArrayLike';
 export { default as gt } from './gt';
 export { default as gte } from './gte';
 export { default as guard } from './guard';

package/types/limit.d.ts

@@ -0,0 +1,28 @@
+import { FunctionAny } from './internals/types';
+/**
+ * 创建一个限流函数，该函数在时间间隔内只会执行一次。
+ *
+ * 与 `throttle` 的区别：
+ * 1. 在时间间隔内再次调用，`limit`不会执行，而`throttle` 会执行；
+ * 2. `limit` 没有取消和立即执行的方法，逻辑更简洁。
+ *
+ * @alias module:Function.limit
+ * @since 1.19.0
+ * @param {Function} fn 要限流的函数。
+ * @param {number} timespan 限流的时间间隔，单位为毫秒。
+ * @returns 限流函数。
+ * @example
+ * function revalidate(){
+ *   if(document.visibilityState !== 'hidden' || navigator.onLine){
+ *     // do something
+ *     console.log('revalidate');
+ *   }
+ * }
+ *
+ * // 限制 5s 内只会执行一次
+ * const limited = limit(revalidate, 5000);
+ *
+ * window.addEventListener('visibilitychange', limited);
+ * window.addEventListener('focus', limited);
+ */
+export default function limit<T extends FunctionAny>(fn: T, timespan: number): (...args: Parameters<T>) => void;

package/types/memoize.d.ts

@@ -10,7 +10,7 @@ type EqualFn<TFunc extends (...args: any[]) => any> = (newArgs: Parameters<TFunc
  * @since 1.17.0
  * @param {Function} func 要缓存结果的函数。
  * @param {Object} [options] 配置项。
- * @param {Function} [options.isEqual] 自定义比较参数方法。默认函数遍历参数并使用 `===` 进行比较。
+ * @param {Function} [options.isEqual] 自定义比较参数方法。默认函数 `equalArrayLike`。
  * @param {number} [options.max] 最大缓存数量，`0`表示不限制。默认`0`。
  * @returns 缓存 `func` 结果的函数。
  * @example

package/types/uniqueId.d.ts

@@ -1,6 +1,10 @@
 /**
  * 生成唯一ID。如果提供了 `prefix`，会被添加到ID前缀上。
  *
+ * 前缀+自增计数器组合。
+ *
+ * 适用于客户端，比如 `DOM id`。不建议在服务端使用自增计数器，可能会溢出。
+ *
  * @alias module:Util.uniqueId
  * @since 1.0.0
  * @param {string} [prefix] 要添加到ID前缀的值。默认 `"_" + 2个随机生成的字符`。
@@ -9,7 +13,7 @@
  *
  * uniqueId(); // '_vn1'
  *
- * uniqueId(); // '_vn2'
+ * uniqueId(); // '_xa2'
  *
  * uniqueId('abc_'); // 'abc_3'
  *