a-js-tools 1.0.3 → 1.0.5

package/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var createConstructor = require('./src/object/createConstructor.cjs');
 var getRandomNumber = require('./src/getRandomNumber.cjs');
 var className = require('./src/className.cjs');
 var getRandomString = require('./src/getRandomString.cjs');
@@ -16,6 +17,7 @@ var symmetricDifference = require('./src/array/symmetricDifference.cjs');
 
 
 
+exports.createConstructor = createConstructor.createConstructor;
 exports.getRandomFloat = getRandomNumber.getRandomFloat;
 exports.getRandomInt = getRandomNumber.getRandomInt;
 exports.toLowerCamelCase = className.toLowerCamelCase;

package/index.d.ts

@@ -1,7 +1,10 @@
+import { CreateConstructor, createConstructor } from 'src/object/createConstructor';
 export { toLowerCamelCase, toSplitCase, getRandomFloat, getRandomInt, getRandomString, } from './src/index';
 export { throttle, debounce } from './src/performance';
 export type { DebounceAndThrottleReturnType } from './src/performance';
 export { escapeRegExp, autoEscapedRegExp } from './src/regexp';
 export { isBrowser, isNode } from './src/isNode';
 export { intersection, enArr, union, difference, symmetricDifference, } from './src/array/';
+export { createConstructor };
+export type { CreateConstructor };
 export { sleep } from './src/sleep';

package/index.mjs

@@ -1,3 +1,4 @@
+export { createConstructor } from './src/object/createConstructor.mjs';
 export { getRandomFloat, getRandomInt } from './src/getRandomNumber.mjs';
 export { toLowerCamelCase, toSplitCase } from './src/className.mjs';
 export { getRandomString } from './src/getRandomString.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "type": "module",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "name": "a-js-tools",
   "description": "一点点 🤏  js 函数",
   "license": "MIT",

package/src/array/difference.cjs

@@ -34,12 +34,10 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function difference(a, b) {
-    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b)) {
+    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b))
         throw new TypeError('参数需为数组');
-    }
-    if (a.length === 0 || b.length === 0) {
+    if (aTypeOfJs.isEmptyArray(a) || aTypeOfJs.isEmptyArray(b))
         return a;
-    }
     /**  获取两个数组中长度较小的  */
     // 参数有顺序要求
     // const [shorter, longer] = a.length > b.length ? [b, a] : [a, b];

package/src/array/difference.mjs

@@ -1,4 +1,4 @@
-import { isArray } from 'a-type-of-js';
+import { isArray, isEmptyArray } from 'a-type-of-js';
 
 /**
  *  求给出的两个数组的差值（A - B）
@@ -32,12 +32,10 @@ import { isArray } from 'a-type-of-js';
  *
  */
 function difference(a, b) {
-    if (!isArray(a) || !isArray(b)) {
+    if (!isArray(a) || !isArray(b))
         throw new TypeError('参数需为数组');
-    }
-    if (a.length === 0 || b.length === 0) {
+    if (isEmptyArray(a) || isEmptyArray(b))
         return a;
-    }
     /**  获取两个数组中长度较小的  */
     // 参数有顺序要求
     // const [shorter, longer] = a.length > b.length ? [b, a] : [a, b];

package/src/array/intersection.cjs

@@ -24,13 +24,11 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function intersection(a, b) {
-    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b)) {
+    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b))
         throw new TypeError('参数必须是数组类型数据');
-    }
     // 任意数组为空，则返回空数组
-    if (a.length === 0 || b.length === 0) {
+    if (aTypeOfJs.isEmptyArray(a) || aTypeOfJs.isEmptyArray(b))
         return [];
-    }
     /**
      * 在实际运算中， new Set() 的 开销为 O(n) ,filter 的开销也为 O(n)
      *

package/src/array/intersection.mjs

@@ -1,4 +1,4 @@
-import { isArray } from 'a-type-of-js';
+import { isArray, isEmptyArray } from 'a-type-of-js';
 
 /**
  *
@@ -22,13 +22,11 @@ import { isArray } from 'a-type-of-js';
  *
  */
 function intersection(a, b) {
-    if (!isArray(a) || !isArray(b)) {
+    if (!isArray(a) || !isArray(b))
         throw new TypeError('参数必须是数组类型数据');
-    }
     // 任意数组为空，则返回空数组
-    if (a.length === 0 || b.length === 0) {
+    if (isEmptyArray(a) || isEmptyArray(b))
         return [];
-    }
     /**
      * 在实际运算中， new Set() 的 开销为 O(n) ,filter 的开销也为 O(n)
      *

package/src/array/symmetricDifference.cjs

@@ -36,15 +36,12 @@ var difference = require('./difference.cjs');
  *
  */
 function symmetricDifference(a, b) {
-    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b)) {
+    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b))
         throw new TypeError('参数必须是数组');
-    }
-    if (a.length === 0) {
+    if (aTypeOfJs.isEmptyArray(a))
         return [...b];
-    }
-    if (b.length === 0) {
+    if (aTypeOfJs.isEmptyArray(b))
         return [...a];
-    }
     return [...difference.difference(a, b), ...difference.difference(b, a)];
 }
 

package/src/array/symmetricDifference.mjs

@@ -1,4 +1,4 @@
-import { isArray } from 'a-type-of-js';
+import { isArray, isEmptyArray } from 'a-type-of-js';
 import { difference } from './difference.mjs';
 
 /**
@@ -34,15 +34,12 @@ import { difference } from './difference.mjs';
  *
  */
 function symmetricDifference(a, b) {
-    if (!isArray(a) || !isArray(b)) {
+    if (!isArray(a) || !isArray(b))
         throw new TypeError('参数必须是数组');
-    }
-    if (a.length === 0) {
+    if (isEmptyArray(a))
         return [...b];
-    }
-    if (b.length === 0) {
+    if (isEmptyArray(b))
         return [...a];
-    }
     return [...difference(a, b), ...difference(b, a)];
 }
 

package/src/array/union.cjs

@@ -44,20 +44,16 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function union(...arrays) {
-    if (arrays.length === 0) {
+    if (aTypeOfJs.isEmptyArray(arrays))
         return [];
-    }
-    if (arrays.some(i => !aTypeOfJs.isArray(i))) {
+    if (arrays.some(i => !aTypeOfJs.isArray(i)))
         throw new TypeError('参数必须都是数组形式的元素');
-    }
-    if (arrays.length === 1) {
+    if (arrays.length === 1)
         return [...arrays[0]];
-    }
     const resultSet = new Set();
     for (const array of arrays) {
-        for (const item of array) {
+        for (const item of array)
             resultSet.add(item);
-        }
     }
     return Array.from(resultSet);
 }

package/src/array/union.mjs

@@ -1,4 +1,4 @@
-import { isArray } from 'a-type-of-js';
+import { isEmptyArray, isArray } from 'a-type-of-js';
 
 /**
  *
@@ -42,20 +42,16 @@ import { isArray } from 'a-type-of-js';
  *
  */
 function union(...arrays) {
-    if (arrays.length === 0) {
+    if (isEmptyArray(arrays))
         return [];
-    }
-    if (arrays.some(i => !isArray(i))) {
+    if (arrays.some(i => !isArray(i)))
         throw new TypeError('参数必须都是数组形式的元素');
-    }
-    if (arrays.length === 1) {
+    if (arrays.length === 1)
         return [...arrays[0]];
-    }
     const resultSet = new Set();
     for (const array of arrays) {
-        for (const item of array) {
+        for (const item of array)
             resultSet.add(item);
-        }
     }
     return Array.from(resultSet);
 }

package/src/className.cjs

@@ -34,9 +34,9 @@ initial = false) {
     /**  转化首字符   */
     const toTransform = (_str, _dividingType) => _str.replace(new RegExp(`${template.test(_dividingType) ? `\\${_dividingType}` : _dividingType}([a-zA-Z])`, 'g'), (match, p1) => p1.toUpperCase());
     // 多分隔符转化
-    dividingType.split('').forEach((item) => {
-        result = toTransform(result, item);
-    });
+    dividingType
+        .split('')
+        .forEach((item) => (result = toTransform(result, item)));
     return initial
         ? result.replace(/^./, (match) => match.toUpperCase())
         : result;

package/src/className.mjs

@@ -32,9 +32,9 @@ initial = false) {
     /**  转化首字符   */
     const toTransform = (_str, _dividingType) => _str.replace(new RegExp(`${template.test(_dividingType) ? `\\${_dividingType}` : _dividingType}([a-zA-Z])`, 'g'), (match, p1) => p1.toUpperCase());
     // 多分隔符转化
-    dividingType.split('').forEach((item) => {
-        result = toTransform(result, item);
-    });
+    dividingType
+        .split('')
+        .forEach((item) => (result = toTransform(result, item)));
     return initial
         ? result.replace(/^./, (match) => match.toUpperCase())
         : result;

package/src/getRandomString.cjs

@@ -38,9 +38,8 @@ function getRandomString(options) {
         (aTypeOfJs.isPlainObject(options) &&
             (!aTypeOfJs.isNumber(options.length) ||
                 options.length < 1 ||
-                !Number.isInteger(options.length)))) {
+                !Number.isInteger(options.length))))
         throw new TypeError('参数类型错误 ❌ (getRandomString)');
-    }
     const initOptions = {
         length: 32,
         chars: 'abcdefghijklmnopqrstuvwxyz',
@@ -52,13 +51,11 @@ function getRandomString(options) {
         includeSpecial: false,
     };
     /// 生成 UUID
-    if (initOptions.type === 'uuid') {
+    if (initOptions.type === 'uuid')
         return crypto.randomUUID();
-    }
-    if (aTypeOfJs.isNumber(options) && Number.isInteger(options) && options > 0) {
-        // 验证输入参数
+    // 验证输入参数
+    if (aTypeOfJs.isNumber(options) && Number.isInteger(options) && options > 0)
         Object.assign(initOptions, { length: options });
-    }
     if (aTypeOfJs.isPlainObject(options)) {
         Object.assign(initOptions, options);
         initOptions.length = initOptions.length < 1 ? 32 : initOptions.length;
@@ -66,17 +63,14 @@ function getRandomString(options) {
     /**  生成随机字符串  */
     const templateCharsArr = initOptions.chars.split('');
     // 添加大写字母
-    if (initOptions.includeUppercaseLetters) {
+    if (initOptions.includeUppercaseLetters)
         interleaveString(templateCharsArr, initOptions.chars.toUpperCase());
-    }
     // 添加数字
-    if (initOptions.includeNumbers) {
+    if (initOptions.includeNumbers)
         interleaveString(templateCharsArr, initOptions.chars2);
-    }
     // 添加特殊字符
-    if (initOptions.includeSpecial) {
+    if (initOptions.includeSpecial)
         interleaveString(templateCharsArr, initOptions.chars3);
-    }
     // 使用密码学安全的随机数生成器
     const bytes = isNode.isBrowser() && window.crypto
         ? window.crypto.getRandomValues(new Uint8Array(initOptions.length))
@@ -104,12 +98,10 @@ function getRandomString(options) {
         const str1Length = str1.length, str2Length = str2.length;
         const maxLength = Math.max(str1Length, str2Length);
         for (let i = 0; i < maxLength; i++) {
-            if (i < str1Length && str2[i] !== undefined) {
+            if (i < str1Length && !aTypeOfJs.isUndefined(str2[i]))
                 str1[i] += str2[i];
-            }
-            else if (i < str2Length) {
+            else if (i < str2Length)
                 str1[i] = str2[i];
-            }
         }
     }
     return result;

package/src/getRandomString.mjs

@@ -1,4 +1,4 @@
-import { isPlainObject, isNumber, isNaN } from 'a-type-of-js';
+import { isPlainObject, isNumber, isNaN, isUndefined } from 'a-type-of-js';
 import { isBrowser } from './isNode.mjs';
 
 /**
@@ -36,9 +36,8 @@ function getRandomString(options) {
         (isPlainObject(options) &&
             (!isNumber(options.length) ||
                 options.length < 1 ||
-                !Number.isInteger(options.length)))) {
+                !Number.isInteger(options.length))))
         throw new TypeError('参数类型错误 ❌ (getRandomString)');
-    }
     const initOptions = {
         length: 32,
         chars: 'abcdefghijklmnopqrstuvwxyz',
@@ -50,13 +49,11 @@ function getRandomString(options) {
         includeSpecial: false,
     };
     /// 生成 UUID
-    if (initOptions.type === 'uuid') {
+    if (initOptions.type === 'uuid')
         return crypto.randomUUID();
-    }
-    if (isNumber(options) && Number.isInteger(options) && options > 0) {
-        // 验证输入参数
+    // 验证输入参数
+    if (isNumber(options) && Number.isInteger(options) && options > 0)
         Object.assign(initOptions, { length: options });
-    }
     if (isPlainObject(options)) {
         Object.assign(initOptions, options);
         initOptions.length = initOptions.length < 1 ? 32 : initOptions.length;
@@ -64,17 +61,14 @@ function getRandomString(options) {
     /**  生成随机字符串  */
     const templateCharsArr = initOptions.chars.split('');
     // 添加大写字母
-    if (initOptions.includeUppercaseLetters) {
+    if (initOptions.includeUppercaseLetters)
         interleaveString(templateCharsArr, initOptions.chars.toUpperCase());
-    }
     // 添加数字
-    if (initOptions.includeNumbers) {
+    if (initOptions.includeNumbers)
         interleaveString(templateCharsArr, initOptions.chars2);
-    }
     // 添加特殊字符
-    if (initOptions.includeSpecial) {
+    if (initOptions.includeSpecial)
         interleaveString(templateCharsArr, initOptions.chars3);
-    }
     // 使用密码学安全的随机数生成器
     const bytes = isBrowser() && window.crypto
         ? window.crypto.getRandomValues(new Uint8Array(initOptions.length))
@@ -102,12 +96,10 @@ function getRandomString(options) {
         const str1Length = str1.length, str2Length = str2.length;
         const maxLength = Math.max(str1Length, str2Length);
         for (let i = 0; i < maxLength; i++) {
-            if (i < str1Length && str2[i] !== undefined) {
+            if (i < str1Length && !isUndefined(str2[i]))
                 str1[i] += str2[i];
-            }
-            else if (i < str2Length) {
+            else if (i < str2Length)
                 str1[i] = str2[i];
-            }
         }
     }
     return result;

package/src/object/createConstructor.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+/**
+ *
+ * 构建一个 Constructor 构造函数
+ *
+ * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
+ *
+ * 函数本身并没有执行任何逻辑，仅是简单的返回了实参自身
+ *
+ * 而经过该函数的包装，构造函数成了能够被 TS 识别为可用 new 实例的构造函数
+ *
+ * @param constructor - 传入一个构造函数
+ * @returns 返回传入的构造函数
+ *
+ * ```ts
+ * import { createConstructor } from "a-js-tools";
+ *
+ * type Tom = {
+ *   a: number
+ * }
+ *
+ * function _Tom (this: TomType): Tom {
+ *    this.a = 1;
+ *
+ *    return this;
+ * }
+ *
+ * // 逻辑上没有错，但是会造成 ts 显示
+ * // 其目标缺少构造签名的 "new" 表达式隐式具有 "any" 类型。ts(7009)
+ * const a = new _Tom();
+ *
+ * const tomConstructor = createConstructor(_tom);
+ *
+ * const b = new tomConstructor(); // 这时就不会显示错误
+ *
+ * ```
+ *
+ */
+function createConstructor(constructor) {
+    return constructor;
+}
+
+exports.createConstructor = createConstructor;

package/src/object/createConstructor.d.ts

@@ -0,0 +1,47 @@
+/**
+ *
+ * 构建构建的构建函数
+ *
+ *
+ */
+export interface CreateConstructor<T, Args extends unknown[] = unknown[]> {
+    new (...args: Args): T;
+}
+/**
+ *
+ * 构建一个 Constructor 构造函数
+ *
+ * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
+ *
+ * 函数本身并没有执行任何逻辑，仅是简单的返回了实参自身
+ *
+ * 而经过该函数的包装，构造函数成了能够被 TS 识别为可用 new 实例的构造函数
+ *
+ * @param constructor - 传入一个构造函数
+ * @returns 返回传入的构造函数
+ *
+ * ```ts
+ * import { createConstructor } from "a-js-tools";
+ *
+ * type Tom = {
+ *   a: number
+ * }
+ *
+ * function _Tom (this: TomType): Tom {
+ *    this.a = 1;
+ *
+ *    return this;
+ * }
+ *
+ * // 逻辑上没有错，但是会造成 ts 显示
+ * // 其目标缺少构造签名的 "new" 表达式隐式具有 "any" 类型。ts(7009)
+ * const a = new _Tom();
+ *
+ * const tomConstructor = createConstructor(_tom);
+ *
+ * const b = new tomConstructor(); // 这时就不会显示错误
+ *
+ * ```
+ *
+ */
+export declare function createConstructor<T, Args extends unknown[] = unknown[]>(constructor: (...argumentList: Args) => T): CreateConstructor<T, Args>;

package/src/object/createConstructor.mjs

@@ -0,0 +1,42 @@
+/**
+ *
+ * 构建一个 Constructor 构造函数
+ *
+ * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
+ *
+ * 函数本身并没有执行任何逻辑，仅是简单的返回了实参自身
+ *
+ * 而经过该函数的包装，构造函数成了能够被 TS 识别为可用 new 实例的构造函数
+ *
+ * @param constructor - 传入一个构造函数
+ * @returns 返回传入的构造函数
+ *
+ * ```ts
+ * import { createConstructor } from "a-js-tools";
+ *
+ * type Tom = {
+ *   a: number
+ * }
+ *
+ * function _Tom (this: TomType): Tom {
+ *    this.a = 1;
+ *
+ *    return this;
+ * }
+ *
+ * // 逻辑上没有错，但是会造成 ts 显示
+ * // 其目标缺少构造签名的 "new" 表达式隐式具有 "any" 类型。ts(7009)
+ * const a = new _Tom();
+ *
+ * const tomConstructor = createConstructor(_tom);
+ *
+ * const b = new tomConstructor(); // 这时就不会显示错误
+ *
+ * ```
+ *
+ */
+function createConstructor(constructor) {
+    return constructor;
+}
+
+export { createConstructor };

package/src/performance.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var aTypeOfJs = require('a-type-of-js');
+
 /**
  * 防抖和节流
  *
@@ -12,7 +14,7 @@
  * 防抖
  *
  * @param   callback 回调函数
- * @param   delay    延迟时间（毫秒），默认 200 (ms)
+ * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
  * @returns   返回的闭包函数
  * @example
  *
@@ -25,13 +27,19 @@
  * }
  *
  */
-function debounce(callback, delay = 200) {
-    if (typeof callback !== 'function') {
+function debounce(callback, options = 200) {
+    if (!aTypeOfJs.isFunction(callback))
         throw new TypeError('callback must be a function');
-    }
-    if (!isFinite(delay) || delay < 0)
+    if (aTypeOfJs.isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (aTypeOfJs.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
         // 强制转换非数值
-        delay = 200;
+        options.delay = 200;
     /**  定时器返回的 id  */
     let timeoutId;
     const clear = () => {
@@ -44,29 +52,36 @@ function debounce(callback, delay = 200) {
         clear();
         timeoutId = setTimeout(() => {
             try {
-                Reflect.apply(callback, null, args);
+                Reflect.apply(callback, options?.this ?? null, args);
             }
             catch (error) {
                 console.log('Debounce callback throw an error', error);
             }
-        }, Math.max(delay, 5));
-    };
-    result.cancel = () => {
-        clear();
+        }, Math.max(options?.delay ?? 5, 5));
     };
+    result.cancel = () => clear();
     return result;
 }
 /**
  *   节流
  *
  * @param callback   回调函数
- * @param delay      延迟时间（毫秒），默认 200 (ms)
+ * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
  * @returns   返回的闭包函数
  */
-function throttle(callback, delay = 200) {
-    // 强制转换非数值
-    if (!isFinite(delay) || (isFinite(delay) && delay < 4))
-        delay = 200;
+function throttle(callback, options = 200) {
+    if (!aTypeOfJs.isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (aTypeOfJs.isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (aTypeOfJs.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
+        // 强制转换非数值
+        options.delay = 200;
     /**  延迟控制插销   */
     let inThrottle = false;
     /**  延迟控制   */
@@ -75,24 +90,22 @@ function throttle(callback, delay = 200) {
         if (inThrottle)
             return;
         try {
-            Reflect.apply(callback, null, args);
+            Reflect.apply(callback, options?.this ?? null, args);
         }
         catch (error) {
-            console.error('Throttle callback throw an error', error);
+            console.error('Throttle 执行回调抛出问题', error);
         }
         inThrottle = true;
-        if (timeoutId !== null) {
+        if (!aTypeOfJs.isNull(timeoutId))
             clearTimeout(timeoutId);
-        }
         timeoutId = setTimeout(() => {
             inThrottle = false;
             timeoutId = null;
-        }, delay);
+        }, Math.max(options?.delay ?? 5, 5));
     };
     throttled.cancel = () => {
-        if (timeoutId !== null) {
+        if (!aTypeOfJs.isNull(timeoutId))
             clearTimeout(timeoutId);
-        }
         inThrottle = false;
         timeoutId = null;
     };

package/src/performance.d.ts

@@ -15,12 +15,17 @@ export interface DebounceAndThrottleReturnType<F extends Callback> {
     (...args: Parameters<F>): void;
     cancel(): void;
 }
+/**  第二参数  */
+export type debounce_throttle_options = {
+    delay?: number;
+    this?: null | unknown;
+} | number;
 /**
  *
  * 防抖
  *
  * @param   callback 回调函数
- * @param   delay    延迟时间（毫秒），默认 200 (ms)
+ * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
  * @returns   返回的闭包函数
  * @example
  *
@@ -33,13 +38,13 @@ export interface DebounceAndThrottleReturnType<F extends Callback> {
  * }
  *
  */
-export declare function debounce<F extends (...args: unknown[]) => void>(callback: F, delay?: number): DebounceAndThrottleReturnType<F>;
+export declare function debounce<F extends (...args: unknown[]) => void>(callback: F, options?: debounce_throttle_options): DebounceAndThrottleReturnType<F>;
 /**
  *   节流
  *
  * @param callback   回调函数
- * @param delay      延迟时间（毫秒），默认 200 (ms)
+ * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
  * @returns   返回的闭包函数
  */
-export declare function throttle<F extends (...args: unknown[]) => void>(callback: F, delay?: number): DebounceAndThrottleReturnType<F>;
+export declare function throttle<F extends (...args: unknown[]) => void>(callback: F, options?: debounce_throttle_options): DebounceAndThrottleReturnType<F>;
 export {};

package/src/performance.mjs

@@ -1,3 +1,5 @@
+import { isFunction, isNumber, isUndefined, isNull } from 'a-type-of-js';
+
 /**
  * 防抖和节流
  *
@@ -10,7 +12,7 @@
  * 防抖
  *
  * @param   callback 回调函数
- * @param   delay    延迟时间（毫秒），默认 200 (ms)
+ * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
  * @returns   返回的闭包函数
  * @example
  *
@@ -23,13 +25,19 @@
  * }
  *
  */
-function debounce(callback, delay = 200) {
-    if (typeof callback !== 'function') {
+function debounce(callback, options = 200) {
+    if (!isFunction(callback))
         throw new TypeError('callback must be a function');
-    }
-    if (!isFinite(delay) || delay < 0)
+    if (isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
         // 强制转换非数值
-        delay = 200;
+        options.delay = 200;
     /**  定时器返回的 id  */
     let timeoutId;
     const clear = () => {
@@ -42,29 +50,36 @@ function debounce(callback, delay = 200) {
         clear();
         timeoutId = setTimeout(() => {
             try {
-                Reflect.apply(callback, null, args);
+                Reflect.apply(callback, options?.this ?? null, args);
             }
             catch (error) {
                 console.log('Debounce callback throw an error', error);
             }
-        }, Math.max(delay, 5));
-    };
-    result.cancel = () => {
-        clear();
+        }, Math.max(options?.delay ?? 5, 5));
     };
+    result.cancel = () => clear();
     return result;
 }
 /**
  *   节流
  *
  * @param callback   回调函数
- * @param delay      延迟时间（毫秒），默认 200 (ms)
+ * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
  * @returns   返回的闭包函数
  */
-function throttle(callback, delay = 200) {
-    // 强制转换非数值
-    if (!isFinite(delay) || (isFinite(delay) && delay < 4))
-        delay = 200;
+function throttle(callback, options = 200) {
+    if (!isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
+        // 强制转换非数值
+        options.delay = 200;
     /**  延迟控制插销   */
     let inThrottle = false;
     /**  延迟控制   */
@@ -73,24 +88,22 @@ function throttle(callback, delay = 200) {
         if (inThrottle)
             return;
         try {
-            Reflect.apply(callback, null, args);
+            Reflect.apply(callback, options?.this ?? null, args);
         }
         catch (error) {
-            console.error('Throttle callback throw an error', error);
+            console.error('Throttle 执行回调抛出问题', error);
         }
         inThrottle = true;
-        if (timeoutId !== null) {
+        if (!isNull(timeoutId))
             clearTimeout(timeoutId);
-        }
         timeoutId = setTimeout(() => {
             inThrottle = false;
             timeoutId = null;
-        }, delay);
+        }, Math.max(options?.delay ?? 5, 5));
     };
     throttled.cancel = () => {
-        if (timeoutId !== null) {
+        if (!isNull(timeoutId))
             clearTimeout(timeoutId);
-        }
         inThrottle = false;
         timeoutId = null;
     };

package/src/regexp/autoEscapedRegExp.cjs

@@ -35,14 +35,12 @@ var parse = require('./parse.cjs');
  *
  */
 function autoEscapedRegExp(pattern, options) {
-    if (!aTypeOfJs.isString(pattern)) {
+    if (!aTypeOfJs.isString(pattern))
         throw new TypeError('pattern must be a 字符串');
-    }
     pattern = escapeRegExp.escapeRegExp(pattern);
     /** 简单转化  */
-    if (aTypeOfJs.isUndefined(options)) {
+    if (aTypeOfJs.isUndefined(options))
         return new RegExp(pattern);
-    }
     options = parse.parse(options);
     return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
 }

package/src/regexp/autoEscapedRegExp.mjs

@@ -33,14 +33,12 @@ import { parse } from './parse.mjs';
  *
  */
 function autoEscapedRegExp(pattern, options) {
-    if (!isString(pattern)) {
+    if (!isString(pattern))
         throw new TypeError('pattern must be a 字符串');
-    }
     pattern = escapeRegExp(pattern);
     /** 简单转化  */
-    if (isUndefined(options)) {
+    if (isUndefined(options))
         return new RegExp(pattern);
-    }
     options = parse(options);
     return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
 }

package/src/regexp/parse.cjs

@@ -15,19 +15,16 @@ function parse(options) {
         };
     }
     // 处理 flags
-    if (!aTypeOfJs.isString(options.flags)) {
+    if (!aTypeOfJs.isString(options.flags))
         options.flags = '';
-    }
     else {
         // 需求是保留字符串中的某一部分，使用
         const regexp = /[migsuy]/g;
         const matchResult = options.flags.match(regexp);
-        if (aTypeOfJs.isNull(matchResult)) {
+        if (aTypeOfJs.isNull(matchResult))
             options.flags = '';
-        }
-        else {
+        else
             options.flags = [...new Set(matchResult)].join('');
-        }
     }
     return options;
 }

package/src/regexp/parse.mjs

@@ -13,19 +13,16 @@ function parse(options) {
         };
     }
     // 处理 flags
-    if (!isString(options.flags)) {
+    if (!isString(options.flags))
         options.flags = '';
-    }
     else {
         // 需求是保留字符串中的某一部分，使用
         const regexp = /[migsuy]/g;
         const matchResult = options.flags.match(regexp);
-        if (isNull(matchResult)) {
+        if (isNull(matchResult))
             options.flags = '';
-        }
-        else {
+        else
             options.flags = [...new Set(matchResult)].join('');
-        }
     }
     return options;
 }

package/src/sleep.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var aTypeOfJs = require('a-type-of-js');
+
 /**
  *
  * ## 线程休息
@@ -28,7 +30,7 @@
 async function sleep(delay = 1000) {
     if (!isFinite(delay) || delay < 0)
         throw new TypeError('delay 应该是一个正常的数值');
-    if (delay === 0)
+    if (aTypeOfJs.isZero(delay))
         return Promise.resolve();
     return new Promise(resolve => setTimeout(resolve, delay));
 }

package/src/sleep.mjs

@@ -1,3 +1,5 @@
+import { isZero } from 'a-type-of-js';
+
 /**
  *
  * ## 线程休息
@@ -26,7 +28,7 @@
 async function sleep(delay = 1000) {
     if (!isFinite(delay) || delay < 0)
         throw new TypeError('delay 应该是一个正常的数值');
-    if (delay === 0)
+    if (isZero(delay))
         return Promise.resolve();
     return new Promise(resolve => setTimeout(resolve, delay));
 }