sculp-js 0.0.2 → 1.0.0

package/lib/cjs/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -8,10 +8,11 @@
 
 /**
  * 选择本地文件
- * @param {function} changeCb 选择文件回调
- * @return {*}
+ * @param {string} accept 上传的文件类型，用于过滤
+ * @param {Function} changeCb 选择文件回调
+ * @returns {HTMLInputElement}
  */
-function chooseLocalFile({ accept }, changeCb) {
+function chooseLocalFile(accept, changeCb) {
     const inputObj = document.createElement('input');
     inputObj.setAttribute('id', String(Date.now()));
     inputObj.setAttribute('type', 'file');

package/lib/cjs/func.js

@@ -0,0 +1,160 @@
+/*!
+ * sculp-js v1.0.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+/**
+ * 防抖函数
+ * 当函数被连续调用时，该函数并不执行，只有当其全部停止调用超过一定时间后才执行1次。
+ * 例如：上电梯的时候，大家陆陆续续进来，电梯的门不会关上，只有当一段时间都没有人上来，电梯才会关门。
+ * @param {F} func
+ * @param {number} wait
+ * @returns {DebounceFunc<F>}
+ */
+const debounce = (func, wait) => {
+    let timeout;
+    let canceled = false;
+    const f = function (...args) {
+        if (canceled)
+            return;
+        clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            func.call(this, ...args);
+        }, wait);
+    };
+    f.cancel = () => {
+        clearTimeout(timeout);
+        canceled = true;
+    };
+    return f;
+};
+/**
+ * 节流函数
+ * 节流就是节约流量，将连续触发的事件稀释成预设评率。 比如每间隔1秒执行一次函数，无论这期间触发多少次事件。
+ * 这有点像公交车，无论在站点等车的人多不多，公交车只会按时来一班，不会来一个人就来一辆公交车。
+ * @param {F} func
+ * @param {number} wait
+ * @param {boolean} immediate
+ * @returns {ThrottleFunc<F>}
+ */
+const throttle = (func, wait, immediate) => {
+    let timeout;
+    let canceled = false;
+    let lastCalledTime = 0;
+    const f = function (...args) {
+        if (canceled)
+            return;
+        const now = Date.now();
+        const call = () => {
+            lastCalledTime = now;
+            func.call(this, ...args);
+        };
+        // 第一次执行
+        if (lastCalledTime === 0) {
+            if (immediate) {
+                return call();
+            }
+            else {
+                lastCalledTime = now;
+                return;
+            }
+        }
+        const remain = lastCalledTime + wait - now;
+        if (remain > 0) {
+            clearTimeout(timeout);
+            timeout = setTimeout(() => call(), wait);
+        }
+        else {
+            call();
+        }
+    };
+    f.cancel = () => {
+        clearTimeout(timeout);
+        canceled = true;
+    };
+    return f;
+};
+/**
+ * 单次函数
+ * @param {AnyFunc} func
+ * @returns {AnyFunc}
+ */
+const once = (func) => {
+    let called = false;
+    let result;
+    return function (...args) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        if (called)
+            return result;
+        called = true;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        result = func.call(this, ...args);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return result;
+    };
+};
+/**
+ * 设置全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+function setGlobal(key, val) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    if (typeof globalThis !== 'undefined')
+        globalThis[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof window !== 'undefined')
+        window[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof global !== 'undefined')
+        global[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof self !== 'undefined')
+        self[key] = val;
+    else
+        throw new SyntaxError('当前环境下无法设置全局属性');
+}
+/**
+ * 设置全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+function getGlobal(key) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    if (typeof globalThis !== 'undefined')
+        return globalThis[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof window !== 'undefined')
+        return window[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof global !== 'undefined')
+        return global[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof self !== 'undefined')
+        return self[key];
+}
+
+exports.debounce = debounce;
+exports.getGlobal = getGlobal;
+exports.once = once;
+exports.setGlobal = setGlobal;
+exports.throttle = throttle;

package/lib/cjs/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -21,6 +21,10 @@ var url = require('./url.js');
 var async = require('./async.js');
 var file = require('./file.js');
 var watermark = require('./watermark.js');
+var func = require('./func.js');
+var random = require('./random.js');
+var number = require('./number.js');
+var unique = require('./unique.js');
 
 
 
@@ -29,7 +33,6 @@ exports.arrayEachAsync = array.arrayEachAsync;
 exports.arrayInsertBefore = array.arrayInsertBefore;
 exports.arrayLike = array.arrayLike;
 exports.arrayRemove = array.arrayRemove;
-exports.asyncForEach = array.asyncForEach;
 exports.deepTraversal = array.deepTraversal;
 exports.getTreeIds = array.getTreeIds;
 exports.copyText = clipboard.copyText;
@@ -38,8 +41,13 @@ exports.cookieGet = cookie.cookieGet;
 exports.cookieSet = cookie.cookieSet;
 exports.calculateDate = date.calculateDate;
 exports.calculateDateTime = date.calculateDateTime;
+exports.dateParse = date.dateParse;
+exports.dateToEnd = date.dateToEnd;
+exports.dateToStart = date.dateToStart;
 exports.formatDate = date.formatDate;
+exports.isValidDate = date.isValidDate;
 exports.addClass = dom.addClass;
+exports.getComputedCssVal = dom.getComputedCssVal;
 exports.getStyle = dom.getStyle;
 exports.hasClass = dom.hasClass;
 exports.isDomReady = dom.isDomReady;
@@ -70,6 +78,7 @@ exports.qsStringify = qs.qsStringify;
 exports.STRING_ARABIC_NUMERALS = string.STRING_ARABIC_NUMERALS;
 exports.STRING_LOWERCASE_ALPHA = string.STRING_LOWERCASE_ALPHA;
 exports.STRING_UPPERCASE_ALPHA = string.STRING_UPPERCASE_ALPHA;
+exports.getStrWidthPx = string.getStrWidthPx;
 exports.stringAssign = string.stringAssign;
 exports.stringCamelCase = string.stringCamelCase;
 exports.stringEscapeHtml = string.stringEscapeHtml;
@@ -91,6 +100,7 @@ exports.isRegExp = type.isRegExp;
 exports.isString = type.isString;
 exports.isSymbol = type.isSymbol;
 exports.isUndefined = type.isUndefined;
+exports.typeIs = type.typeIs;
 exports.urlDelParams = url.urlDelParams;
 exports.urlParse = url.urlParse;
 exports.urlSetParams = url.urlSetParams;
@@ -99,3 +109,19 @@ exports.asyncMap = async.asyncMap;
 exports.wait = async.wait;
 exports.chooseLocalFile = file.chooseLocalFile;
 exports.genCanvasWM = watermark.genCanvasWM;
+exports.debounce = func.debounce;
+exports.getGlobal = func.getGlobal;
+exports.once = func.once;
+exports.setGlobal = func.setGlobal;
+exports.throttle = func.throttle;
+exports.STRING_POOL = random.STRING_POOL;
+exports.randomNumber = random.randomNumber;
+exports.randomString = random.randomString;
+exports.randomUuid = random.randomUuid;
+exports.HEX_POOL = number.HEX_POOL;
+exports.formatNumber = number.formatNumber;
+exports.numberAbbr = number.numberAbbr;
+exports.numberToHex = number.numberToHex;
+exports.UNIQUE_NUMBER_SAFE_LENGTH = unique.UNIQUE_NUMBER_SAFE_LENGTH;
+exports.uniqueNumber = unique.uniqueNumber;
+exports.uniqueString = unique.uniqueString;

package/lib/cjs/number.js

@@ -0,0 +1,82 @@
+/*!
+ * sculp-js v1.0.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var func = require('./func.js');
+var string = require('./string.js');
+
+const HEX_POOL = `${string.STRING_ARABIC_NUMERALS}${string.STRING_UPPERCASE_ALPHA}${string.STRING_LOWERCASE_ALPHA}`;
+const supportBigInt = typeof BigInt !== 'undefined';
+const jsbi = () => func.getGlobal('JSBI');
+const toBigInt = (n) => (supportBigInt ? BigInt(n) : jsbi().BigInt(n));
+const divide = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
+const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
+/**
+ * 将十进制转换成任意进制
+ * @param {number | string} decimal 十进制数值或字符串，可以是任意长度，会使用大数进行计算
+ * @param {string} [hexPool] 进制池，默认 62 进制
+ * @returns {string}
+ */
+function numberToHex(decimal, hexPool = HEX_POOL) {
+    if (hexPool.length < 2)
+        throw new Error('进制池长度不能少于 2');
+    if (!supportBigInt) {
+        throw new Error('需要安装 jsbi 模块并将 JSBI 设置为全局变量：\nimport JSBI from "jsbi"; window.JSBI = JSBI;');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    let bigInt = toBigInt(decimal);
+    const ret = [];
+    const { length } = hexPool;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const bigLength = toBigInt(length);
+    const execute = () => {
+        const y = Number(remainder(bigInt, bigLength));
+        bigInt = divide(bigInt, bigLength);
+        ret.unshift(hexPool[y]);
+        if (bigInt > 0) {
+            execute();
+        }
+    };
+    execute();
+    return ret.join('');
+}
+/**
+ * 缩写
+ * @param {number | string} num
+ * @param {Array<string>} units
+ * @param {number} ratio
+ * @param {number} exponent
+ * @returns {string}
+ */
+const numberAbbr = (num, units, ratio = 1000, exponent) => {
+    const { length } = units;
+    if (length === 0)
+        throw new Error('至少需要一个单位');
+    let num2 = Number(num);
+    let times = 0;
+    while (num2 >= ratio && times < length - 1) {
+        num2 = num2 / ratio;
+        times++;
+    }
+    const value = num2.toFixed(exponent);
+    const unit = units[times];
+    return value.toString() + '' + unit;
+};
+/**
+ * 将数字格式化成千位分隔符显示的字符串
+ * @param {number} val 数字
+ * @param {'int' | 'float'} type 展示分段显示的类型 int:整型 | float:浮点型
+ * @returns {string}
+ */
+function formatNumber(val, type = 'int') {
+    return type === 'int' ? parseInt(String(val)).toLocaleString() : Number(val).toLocaleString('en-US');
+}
+
+exports.HEX_POOL = HEX_POOL;
+exports.formatNumber = formatNumber;
+exports.numberAbbr = numberAbbr;
+exports.numberToHex = numberToHex;

package/lib/cjs/object.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -29,20 +29,22 @@ const isPlainObject = (obj) => {
  * @param {string} key
  * @returns {boolean}
  */
-const objectHas = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
+function objectHas(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
 /**
  * 遍历对象，返回 false 中断遍历
  * @param {O} obj
  * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
  */
-const objectEach = (obj, iterator) => {
+function objectEach(obj, iterator) {
     for (const key in obj) {
         if (!objectHas(obj, key))
             continue;
         if (iterator(obj[key], key) === false)
             break;
     }
-};
+}
 /**
  * 异步遍历对象，返回 false 中断遍历
  * @param {O} obj
@@ -109,8 +111,8 @@ function objectOmit(obj, keys) {
 const merge = (map, source, target) => {
     if (type.isUndefined(target))
         return source;
-    const sourceType = type.default(source);
-    const targetType = type.default(target);
+    const sourceType = type.typeIs(source);
+    const targetType = type.typeIs(target);
     if (sourceType !== targetType) {
         if (type.isArray(target))
             return merge(map, [], target);
@@ -148,7 +150,7 @@ const merge = (map, source, target) => {
  * @param {ObjectAssignItem | undefined} targets
  * @returns {R}
  */
-const objectAssign = (source, ...targets) => {
+function objectAssign(source, ...targets) {
     const map = new Map();
     for (let i = 0; i < targets.length; i++) {
         const target = targets[i];
@@ -158,7 +160,7 @@ const objectAssign = (source, ...targets) => {
     }
     map.clear();
     return source;
-};
+}
 /**
  * 对象填充
  * @param {Partial<R>} source
@@ -166,7 +168,7 @@ const objectAssign = (source, ...targets) => {
  * @param {(s: Partial<R>, t: Partial<R>, key: keyof R) => boolean} fillable
  * @returns {R}
  */
-const objectFill = (source, target, fillable) => {
+function objectFill(source, target, fillable) {
     const _fillable = fillable || ((source, target, key) => source[key] === undefined);
     objectEach(target, (val, key) => {
         if (_fillable(source, target, key)) {
@@ -174,7 +176,7 @@ const objectFill = (source, target, fillable) => {
         }
     });
     return source;
-};
+}
 function objectGet(obj, path, strict = false) {
     path = path.replace(/\[(\w+)\]/g, '.$1');
     path = path.replace(/^\./, '');
@@ -207,7 +209,7 @@ function objectGet(obj, path, strict = false) {
  * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
  * @param {AnyObject | AnyArray} obj
  * @param {WeakMap} map
- * @return {AnyObject | AnyArray}
+ * @returns {AnyObject | AnyArray}
  */
 function cloneDeep(obj, map = new WeakMap()) {
     if (obj instanceof Date)

package/lib/cjs/path.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/cjs/qs.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -14,7 +14,7 @@ var type = require('./type.js');
  * @param {string} queryString
  * @returns {Params}
  */
-const qsParse = (queryString) => {
+function qsParse(queryString) {
     const params = new URLSearchParams(queryString);
     const result = {};
     for (const [key, val] of params.entries()) {
@@ -28,7 +28,7 @@ const qsParse = (queryString) => {
         result[key] = params.getAll(key);
     }
     return result;
-};
+}
 const defaultReplacer = (val) => {
     if (type.isString(val))
         return val;
@@ -46,7 +46,7 @@ const defaultReplacer = (val) => {
  * @param {Replacer} replacer
  * @returns {string}
  */
-const qsStringify = (query, replacer = defaultReplacer) => {
+function qsStringify(query, replacer = defaultReplacer) {
     const params = new URLSearchParams();
     object.objectEach(query, (val, key) => {
         if (type.isArray(val)) {
@@ -65,7 +65,7 @@ const qsStringify = (query, replacer = defaultReplacer) => {
         }
     });
     return params.toString();
-};
+}
 
 exports.qsParse = qsParse;
 exports.qsStringify = qsStringify;

package/lib/cjs/random.js

@@ -0,0 +1,72 @@
+/*!
+ * sculp-js v1.0.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var string = require('./string.js');
+var type = require('./type.js');
+
+/**
+ * 随机整数
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+const randomNumber = (min, max) => Math.floor(Math.random() * (max - min + 1) + min);
+const STRING_POOL = `${string.STRING_ARABIC_NUMERALS}${string.STRING_UPPERCASE_ALPHA}${string.STRING_LOWERCASE_ALPHA}`;
+/**
+ * 随机字符串
+ * @param {number | string} length
+ * @param {string} pool
+ * @returns {string}
+ */
+const randomString = (length, pool) => {
+    let _length = 0;
+    let _pool = STRING_POOL;
+    if (type.isString(pool)) {
+        _length = length;
+        _pool = pool;
+    }
+    else if (type.isNumber(length)) {
+        _length = length;
+    }
+    else if (type.isString(length)) {
+        _pool = length;
+    }
+    let times = Math.max(_length, 1);
+    let result = '';
+    const min = 0;
+    const max = _pool.length - 1;
+    if (max < 2)
+        throw new Error('字符串池长度不能少于 2');
+    while (times--) {
+        const index = randomNumber(min, max);
+        result += _pool[index];
+    }
+    return result;
+};
+/**
+ * 优先浏览器原生能力获取 UUID v4
+ * @returns {string}
+ */
+function randomUuid() {
+    if (typeof URL === 'undefined' || !URL.createObjectURL || typeof Blob === 'undefined') {
+        const hex = '0123456789abcdef';
+        const model = 'xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx';
+        let str = '';
+        for (let i = 0; i < model.length; i++) {
+            const rnd = randomNumber(0, 15);
+            str += model[i] == '-' || model[i] == '4' ? model[i] : hex[rnd];
+        }
+        return str;
+    }
+    return /[^/]+$/.exec(URL.createObjectURL(new Blob()).slice())[0];
+}
+
+exports.STRING_POOL = STRING_POOL;
+exports.randomNumber = randomNumber;
+exports.randomString = randomString;
+exports.randomUuid = randomUuid;

package/lib/cjs/string.js

@@ -1,35 +1,37 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
+var type = require('./type.js');
+
 /**
  * 将字符串转换为驼峰格式
  * @param {string} string
  * @param {boolean} [bigger] 是否大写第一个字母
  * @returns {string}
  */
-const stringCamelCase = (string, bigger) => {
+function stringCamelCase(string, bigger) {
     let string2 = string;
     if (bigger) {
         string2 = string.replace(/^./, origin => origin.toUpperCase());
     }
     const HUMP_RE = /[\s_-](.)/g;
     return string2.replace(HUMP_RE, (orign, char) => char.toUpperCase());
-};
+}
 /**
  * 将字符串转换为连字格式
  * @param {string} string
  * @param {string} [separator] 分隔符，默认是"-"（短横线）
  * @returns {string}
  */
-const stringKebabCase = (string, separator = '-') => {
+function stringKebabCase(string, separator = '-') {
     const string2 = string.replace(/^./, origin => origin.toLowerCase());
     return string2.replace(/[A-Z]/g, origin => `${separator}${origin.toLowerCase()}`);
-};
+}
 const STRING_ARABIC_NUMERALS = '0123456789';
 const STRING_LOWERCASE_ALPHA = 'abcdefghijklmnopqrstuvwxyz';
 const STRING_UPPERCASE_ALPHA = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
@@ -45,7 +47,7 @@ const placeholderRE = /%[%sdo]/g;
  * @param args
  * @returns {string}
  */
-const stringFormat = (string, ...args) => {
+function stringFormat(string, ...args) {
     let index = 0;
     const result = string.replace(placeholderRE, (origin) => {
         const arg = args[index++];
@@ -63,7 +65,7 @@ const stringFormat = (string, ...args) => {
         }
     });
     return [result, ...args.splice(index).map(String)].join(' ');
-};
+}
 const ev = (expression, data) => {
     try {
         // eslint-disable-next-line @typescript-eslint/no-implied-eval,@typescript-eslint/no-unsafe-return
@@ -122,10 +124,41 @@ const stringEscapeHtml = (html) => {
  * @returns {string}
  */
 const stringFill = (length, value = ' ') => new Array(length).fill(value).join('');
+/**
+ * 字符串的像素宽度
+ * @param {string} str 目标字符串
+ * @param {number} fontSize 字符串字体大小
+ * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+ * @returns {*}
+ */
+function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
+    let strWidth = 0;
+    console.assert(type.isString(str), `${str} 不是有效的字符串`);
+    if (type.isString(str) && str.length > 0) {
+        let getEle = document.querySelector('#getStrWidth1494304949567');
+        if (!getEle) {
+            const _ele = document.createElement('span');
+            _ele.id = 'getStrWidth1494304949567';
+            _ele.style.fontSize = fontSize + 'px';
+            _ele.style.whiteSpace = 'nowrap';
+            _ele.style.visibility = 'hidden';
+            _ele.textContent = str;
+            document.body.appendChild(_ele);
+            getEle = _ele;
+        }
+        getEle.textContent = str;
+        strWidth = getEle.offsetWidth;
+        if (isRemoveDom) {
+            document.body.appendChild(getEle);
+        }
+    }
+    return strWidth;
+}
 
 exports.STRING_ARABIC_NUMERALS = STRING_ARABIC_NUMERALS;
 exports.STRING_LOWERCASE_ALPHA = STRING_LOWERCASE_ALPHA;
 exports.STRING_UPPERCASE_ALPHA = STRING_UPPERCASE_ALPHA;
+exports.getStrWidthPx = getStrWidthPx;
 exports.stringAssign = stringAssign;
 exports.stringCamelCase = stringCamelCase;
 exports.stringEscapeHtml = stringEscapeHtml;

package/lib/cjs/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -8,6 +8,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+/**
+ * 判断任意值的数据类型
+ * @param {unknown} any
+ * @returns {string}
+ */
 const typeIs = (any) => Object.prototype.toString.call(any).slice(8, -1);
 // 基本数据类型判断
 const isString = (any) => typeof any === 'string';
@@ -21,7 +26,11 @@ const isPrimitive = (any) => any === null || typeof any !== 'object';
 // 复合数据类型判断
 const isObject = (any) => typeIs(any) === 'Object';
 const isArray = (any) => Array.isArray(any);
-// eslint-disable-next-line @typescript-eslint/ban-types
+/**
+ * 判断是否为函数
+ * @param {unknown} any
+ * @returns {boolean}
+ */
 const isFunction = (any) => typeof any === 'function';
 // 对象类型判断
 const isNaN = (any) => Number.isNaN(any);
@@ -45,3 +54,4 @@ exports.isRegExp = isRegExp;
 exports.isString = isString;
 exports.isSymbol = isSymbol;
 exports.isUndefined = isUndefined;
+exports.typeIs = typeIs;