a2bei4-utils 1.0.0

package/dist/common.cjs

@@ -0,0 +1,391 @@
+'use strict';
+
+//#region 数据类型判断
+
+/**
+ * 返回任意值的运行时类型字符串（小写形式）。
+ * 
+ * @param {*} obj 待检测的值
+ * @returns {keyof globalThis|"blob"|"file"|"formdata"|string} 小写类型名
+ */
+function getDataType(obj) {
+    return Object.prototype.toString
+        .call(obj)
+        .replace(/^\[object\s(\w+)\]$/, "$1")
+        .toLowerCase();
+}
+
+/**
+ * 判断值是否为原生 Blob（含 File）。
+ * 
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Blob}
+ */
+function isBlob(obj) {
+    return getDataType(obj) === "blob";
+}
+
+/**
+ * 判断值是否为**纯粹**的 Object（即 `{}` 或 `new Object()`，不含数组、null、自定义类等）。
+ * 
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Record<PropertyKey, any>}
+ */
+function isPlainObject(obj) {
+    return getDataType(obj) === "object";
+}
+
+/**
+ * 判断值是否为 Promise（含 Promise 子类）。
+ * 
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Promise<any>}
+ */
+function isPromise(obj) {
+    return getDataType(obj) === "promise";
+}
+
+/**
+ * 判断值是否为合法 Date 对象（含 Invalid Date 返回 false）。
+ *
+ * @param {*} t - 待检测值
+ * @returns {t is Date}
+ */
+function isDate(t) {
+    return getDataType(t) === "date";
+}
+
+/**
+ * 判断值是否为函数（含异步函数、生成器函数、类）。
+ * 
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Function}
+ */
+function isFunction(obj) {
+    return typeof obj === "function";
+}
+
+/**
+ * 判断值是否为**非空**字符串。
+ * 
+ * @param {*} obj - 待检测的值
+ * @returns {obj is string}
+ */
+function isNonEmptyString(obj) {
+    return getDataType(obj) === "string" && obj.length > 0;
+}
+
+//#endregion
+
+//#region 随机数据
+
+/**
+ * 在闭区间 [min, max] 内生成一个均匀分布的随机整数。
+ * 若 min > max 则自动交换。
+ *
+ * @param {number} min - 整数下界（包含）
+ * @param {number} max - 整数上界（包含）
+ * @returns {number}
+ * @throws {TypeError} 当 min 或 max 不是整数时抛出
+ */
+function randomIntInRange(min, max) {
+    if (!Number.isInteger(min) || !Number.isInteger(max)) {
+        throw new TypeError("Arguments must be integers");
+    }
+    if (min > max) [min, max] = [max, min];
+    // 注意加 1，否则 max 永远取不到；Math.floor 保证均匀
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+/**
+ * 随机生成一个汉字（可控制范围）。
+ *
+ * @param {boolean} [base=true]  - 是否启用基本区（0x4E00-0x9FA5）
+ * @param {boolean} [extA=false] - 是否启用扩展 A 区（0x3400-0x4DBF）
+ * @param {boolean} [extBH=false] - 是否启用扩展 B~H 区（0x20000-0x2EBEF，代理对）
+ * @returns {string} 单个汉字字符
+ * @throws {RangeError} 未启用任何区段时抛出
+ */
+function randomHan(base = true, extA = false, extBH = false) {
+    // 1. 收集已启用的“区段”
+    const ranges = [];
+    if (base) ranges.push({ min: 0x4e00, max: 0x9fa5, surrogate: false });
+    if (extA) ranges.push({ min: 0x3400, max: 0x4dbf, surrogate: false });
+    if (extBH) ranges.push({ min: 0x20000, max: 0x2ebef, surrogate: true });
+
+    if (ranges.length === 0) {
+        throw new RangeError("At least one range must be enabled");
+    }
+
+    // 2. 按总码位数抽号
+    const total = ranges.reduce((sum, r) => sum + (r.max - r.min + 1), 0);
+    let n = randomIntInRange(0, total - 1);
+
+    // 3. 定位落在哪个区段
+    for (const { min, max, surrogate } of ranges) {
+        const size = max - min + 1;
+        if (n < size) {
+            const code = min + n;
+            if (!surrogate) return String.fromCharCode(code);
+            // 代理对
+            const offset = code - 0x10000;
+            const hi = (offset >> 10) + 0xd800;
+            const lo = (offset & 0x3ff) + 0xdc00;
+            return String.fromCharCode(hi, lo);
+        }
+        n -= size;
+    }
+}
+
+/**
+ * 随机生成一个英文字母。
+ *
+ * @param {'lower'|'upper'} [type] - 指定大小写；留空则随机
+ * @returns {string} 单个字母
+ */
+function randomEnLetter(type) {
+    const lower = "abcdefghijklmnopqrstuvwxyz";
+    const upper = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    const randomNum = randomIntInRange(0, 25);
+
+    switch (type) {
+        case "lower":
+            return lower[randomNum];
+        case "upper":
+            return upper[randomNum];
+        default:
+            return (Math.random() < 0.5 ? lower : upper)[randomNum];
+    }
+}
+
+/**
+ * 生成指定长度的随机“中英混合”字符串。
+ *
+ * @param {number} [len=1] - 目标长度（≥1，自动取整）
+ * @param {number} [zhProb=0.5] - 每个位置选择汉字的概率，默认 0.5
+ * @returns {string}
+ */
+function randomHanOrEn(len, zhProb = 0.5) {
+    len = Math.max(1, Math.floor(len));
+    const buf = [];
+    for (let i = 0; i < len; i++) {
+        buf.push(Math.random() < zhProb ? randomHan() : randomEnLetter());
+    }
+    return buf.join("");
+}
+
+//#endregion
+
+//#region 防抖节流
+
+/**
+ * 创建 debounced（防抖）函数。
+ * - 默认 trailing 触发；当 `leading=true` 时，首次调用或超过等待间隔会立即执行。
+ * - 支持手动取消。
+ *
+ * @template {(...args: any[]) => any} T
+ * @param {T} fn - 要防抖的原始函数
+ * @param {number} wait - 防抖等待时间（毫秒）
+ * @param {boolean} [leading=false] - 是否启用立即执行（leading edge）
+ * @returns {T & { cancel(): void }} 返回经过防抖包装的函数，并附带 `cancel` 方法
+ * @throws {TypeError} 当 `fn` 不是函数时抛出
+ */
+function debounce(fn, wait, leading = false) {
+    if (typeof fn !== "function") throw new TypeError("fn must be function");
+    wait = Math.max(0, Number(wait) || 0);
+    let timeoutId;
+    let lastCall = 0; // 0 表示从未调用过
+
+    function debounced(...args) {
+        const isFirst = lastCall === 0;
+        const isOverWait = Date.now() - lastCall >= wait;
+
+        clearTimeout(timeoutId);
+
+        // 首次调用 || 已达到等待间隔
+        if (leading && (isFirst || isOverWait)) {
+            lastCall = Date.now();
+            return fn.apply(this, args);
+        }
+
+        timeoutId = setTimeout(() => {
+            lastCall = Date.now();
+            fn.apply(this, args);
+        }, wait);
+    }
+
+    debounced.cancel = () => {
+        clearTimeout(timeoutId);
+        lastCall = 0; // 恢复初始状态
+    };
+
+    return debounced;
+}
+
+/**
+ * 创建 throttled（节流）函数。
+ * 支持 leading/trailing 边缘触发，可手动取消。
+ *
+ * @template {(...args: any[]) => any} T
+ * @param {T} fn - 要节流的原始函数
+ * @param {number} wait - 节流间隔（毫秒）
+ * @param {object} [options] - 配置项
+ * @param {boolean} [options.leading=true] - 是否在 leading 边缘执行
+ * @param {boolean} [options.trailing=true] - 是否在 trailing 边缘执行
+ * @returns {T & { cancel(): void }} 返回经过节流包装的函数，并附带 `cancel` 方法
+ * @throws {TypeError} 当 `fn` 不是函数时抛出
+ */
+function throttle(fn, wait, { leading = true, trailing = true } = {}) {
+    if (typeof fn !== "function") throw new TypeError("fn must be function");
+    wait = Math.max(0, Number(wait) || 0);
+
+    let timeoutId = null,
+        lastCall = 0;
+
+    function throttled(...args) {
+        const remaining = wait - (Date.now() - lastCall);
+
+        if (leading && (lastCall === 0 || remaining <= 0)) {
+            lastCall = Date.now();
+            fn.apply(this, args);
+        } else if (trailing && !timeoutId) {
+            timeoutId = setTimeout(
+                () => {
+                    timeoutId = null;
+                    lastCall = Date.now();
+                    fn.apply(this, args);
+                },
+                remaining > 0 ? remaining : wait
+            );
+        }
+    }
+
+    throttled.cancel = () => {
+        clearTimeout(timeoutId);
+        timeoutId = null;
+        lastCall = 0;
+    };
+
+    return throttled;
+}
+
+//#endregion
+
+/**
+ * 利用 JSON 序列化/反序列化实现**深拷贝**。
+ * 注意：会丢失 `undefined`、函数、循环引用、特殊包装对象等。
+ *
+ * @template T
+ * @param {T} obj - 待拷贝的 JSON 兼容值
+ * @returns {T} 深拷贝后的值
+ */
+function deepCloneByJSON(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+
+/**
+ * **安全**地将源对象中**已存在**的属性赋值到目标对象。
+ * 不会新增键，也不会复制原型链上的属性。
+ *
+ * @template {Record<PropertyKey, any>} T
+ * @param {T} target - 目标对象（将被就地修改）
+ * @param {...Partial<T>} sources - 一个或多个源对象
+ * @returns {T} 修改后的目标对象（即第一个参数本身）
+ *
+ * @example
+ * const defaults = { a: 1, b: 2 };
+ * assignExisting(defaults, { a: 9, c: 99 }); // defaults 变为 { a: 9, b: 2 }
+ */
+function assignExisting(target, ...sources) {
+    sources.forEach((source) => {
+        Object.keys(source).forEach((key) => {
+            if (target.hasOwnProperty(key)) {
+                target[key] = source[key];
+            }
+        });
+    });
+    return target;
+}
+
+/**
+ * 提取任意函数（含箭头函数、普通函数、async、class 构造器）的形参名称列表。
+ * 通过源码正则解析，不支持解构参数、默认参数、剩余参数等复杂语法；
+ * 若出现上述场景将返回空数组或部分名称。
+ *
+ * @param {Function} fn - 目标函数
+ * @returns {string[]} 按声明顺序排列的参数名数组；解析失败时返回空数组
+ *
+ * @example
+ * getFunctionArgNames(function (a, b) {})        // ["a", "b"]
+ * getFunctionArgNames((foo, bar) => {})          // ["foo", "bar"]
+ * getFunctionArgNames(async function x({a} = {}) {}) // [] （解构无法识别）
+ */
+function getFunctionArgNames(fn) {
+    const FN_ARG_SPLIT = /,/,
+        FN_ARG = /^\s*(_?)(\S+?)\1\s*$/,
+        FN_ARGS = /^[^(]*\(\s*([^)]*)\)/m,
+        ARROW_ARG = /^([^(]+?)=>/,
+        STRIP_COMMENTS = /((\/\/.*$)|(\/\*[\s\S]*?\*\/))/gm;
+
+    const fnText = Function.prototype.toString.call(fn).replace(STRIP_COMMENTS, "");
+    const argDecl = fnText.match(ARROW_ARG) || fnText.match(FN_ARGS);
+    const retArgNames = [];
+    [].forEach.call(argDecl[1].split(FN_ARG_SPLIT), function (arg) {
+        arg.replace(FN_ARG, function (all, underscore, name) {
+            retArgNames.push(name);
+        });
+    });
+    return retArgNames;
+}
+
+/**
+ * 将 Blob（或 File）读取为文本，并可选择自动执行 `JSON.parse`。
+ * 当 `isParse=true` 且内容非法 JSON 时，会回退为返回原始文本。
+ *
+ * @param {Blob} blob - 待读取的 Blob/File 对象
+ * @param {boolean} [isParse=true] - 是否尝试将结果按 JSON 解析
+ * @returns {Promise<string | any>} 解析后的 JSON 对象或原始文本
+ *
+ * @example
+ * const json = await readBlobAsText(blob);        // 自动 JSON.parse
+ * const text = await readBlobAsText(blob, false); // 仅返回文本
+ */
+function readBlobAsText(blob, isParse = true) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (evt) => {
+            const result = evt.target.result;
+            if (isParse) {
+                try {
+                    resolve(JSON.parse(result));
+                } catch (error) {
+                    console.error(error);
+                    resolve(result);
+                }
+            } else {
+                resolve(result);
+            }
+        };
+        reader.onerror = reject;
+        reader.readAsText(blob);
+    });
+}
+
+exports.assignExisting = assignExisting;
+exports.debounce = debounce;
+exports.deepCloneByJSON = deepCloneByJSON;
+exports.getDataType = getDataType;
+exports.getFunctionArgNames = getFunctionArgNames;
+exports.isBlob = isBlob;
+exports.isDate = isDate;
+exports.isFunction = isFunction;
+exports.isNonEmptyString = isNonEmptyString;
+exports.isPlainObject = isPlainObject;
+exports.isPromise = isPromise;
+exports.randomEnLetter = randomEnLetter;
+exports.randomHan = randomHan;
+exports.randomHanOrEn = randomHanOrEn;
+exports.randomIntInRange = randomIntInRange;
+exports.readBlobAsText = readBlobAsText;
+exports.throttle = throttle;
+//# sourceMappingURL=common.cjs.map

package/dist/common.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.cjs","sources":["../src/source/common.js"],"sourcesContent":["//#region 数据类型判断\n\n/**\n * 返回任意值的运行时类型字符串（小写形式）。\n * \n * @param {*} obj 待检测的值\n * @returns {keyof globalThis|\"blob\"|\"file\"|\"formdata\"|string} 小写类型名\n */\nexport function getDataType(obj) {\n    return Object.prototype.toString\n        .call(obj)\n        .replace(/^\\[object\\s(\\w+)\\]$/, \"$1\")\n        .toLowerCase();\n}\n\n/**\n * 判断值是否为原生 Blob（含 File）。\n * \n * @param {*} obj - 待检测的值\n * @returns {obj is Blob}\n */\nexport function isBlob(obj) {\n    return getDataType(obj) === \"blob\";\n}\n\n/**\n * 判断值是否为**纯粹**的 Object（即 `{}` 或 `new Object()`，不含数组、null、自定义类等）。\n * \n * @param {*} obj - 待检测的值\n * @returns {obj is Record<PropertyKey, any>}\n */\nexport function isPlainObject(obj) {\n    return getDataType(obj) === \"object\";\n}\n\n/**\n * 判断值是否为 Promise（含 Promise 子类）。\n * \n * @param {*} obj - 待检测的值\n * @returns {obj is Promise<any>}\n */\nexport function isPromise(obj) {\n    return getDataType(obj) === \"promise\";\n}\n\n/**\n * 判断值是否为合法 Date 对象（含 Invalid Date 返回 false）。\n *\n * @param {*} t - 待检测值\n * @returns {t is Date}\n */\nexport function isDate(t) {\n    return getDataType(t) === \"date\";\n}\n\n/**\n * 判断值是否为函数（含异步函数、生成器函数、类）。\n * \n * @param {*} obj - 待检测的值\n * @returns {obj is Function}\n */\nexport function isFunction(obj) {\n    return typeof obj === \"function\";\n}\n\n/**\n * 判断值是否为**非空**字符串。\n * \n * @param {*} obj - 待检测的值\n * @returns {obj is string}\n */\nexport function isNonEmptyString(obj) {\n    return getDataType(obj) === \"string\" && obj.length > 0;\n}\n\n//#endregion\n\n//#region 随机数据\n\n/**\n * 在闭区间 [min, max] 内生成一个均匀分布的随机整数。\n * 若 min > max 则自动交换。\n *\n * @param {number} min - 整数下界（包含）\n * @param {number} max - 整数上界（包含）\n * @returns {number}\n * @throws {TypeError} 当 min 或 max 不是整数时抛出\n */\nexport function randomIntInRange(min, max) {\n    if (!Number.isInteger(min) || !Number.isInteger(max)) {\n        throw new TypeError(\"Arguments must be integers\");\n    }\n    if (min > max) [min, max] = [max, min];\n    // 注意加 1，否则 max 永远取不到；Math.floor 保证均匀\n    return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * 随机生成一个汉字（可控制范围）。\n *\n * @param {boolean} [base=true]  - 是否启用基本区（0x4E00-0x9FA5）\n * @param {boolean} [extA=false] - 是否启用扩展 A 区（0x3400-0x4DBF）\n * @param {boolean} [extBH=false] - 是否启用扩展 B~H 区（0x20000-0x2EBEF，代理对）\n * @returns {string} 单个汉字字符\n * @throws {RangeError} 未启用任何区段时抛出\n */\nexport function randomHan(base = true, extA = false, extBH = false) {\n    // 1. 收集已启用的“区段”\n    const ranges = [];\n    if (base) ranges.push({ min: 0x4e00, max: 0x9fa5, surrogate: false });\n    if (extA) ranges.push({ min: 0x3400, max: 0x4dbf, surrogate: false });\n    if (extBH) ranges.push({ min: 0x20000, max: 0x2ebef, surrogate: true });\n\n    if (ranges.length === 0) {\n        throw new RangeError(\"At least one range must be enabled\");\n    }\n\n    // 2. 按总码位数抽号\n    const total = ranges.reduce((sum, r) => sum + (r.max - r.min + 1), 0);\n    let n = randomIntInRange(0, total - 1);\n\n    // 3. 定位落在哪个区段\n    for (const { min, max, surrogate } of ranges) {\n        const size = max - min + 1;\n        if (n < size) {\n            const code = min + n;\n            if (!surrogate) return String.fromCharCode(code);\n            // 代理对\n            const offset = code - 0x10000;\n            const hi = (offset >> 10) + 0xd800;\n            const lo = (offset & 0x3ff) + 0xdc00;\n            return String.fromCharCode(hi, lo);\n        }\n        n -= size;\n    }\n}\n\n/**\n * 随机生成一个英文字母。\n *\n * @param {'lower'|'upper'} [type] - 指定大小写；留空则随机\n * @returns {string} 单个字母\n */\nexport function randomEnLetter(type) {\n    const lower = \"abcdefghijklmnopqrstuvwxyz\";\n    const upper = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n    const randomNum = randomIntInRange(0, 25);\n\n    switch (type) {\n        case \"lower\":\n            return lower[randomNum];\n        case \"upper\":\n            return upper[randomNum];\n        default:\n            return (Math.random() < 0.5 ? lower : upper)[randomNum];\n    }\n}\n\n/**\n * 生成指定长度的随机“中英混合”字符串。\n *\n * @param {number} [len=1] - 目标长度（≥1，自动取整）\n * @param {number} [zhProb=0.5] - 每个位置选择汉字的概率，默认 0.5\n * @returns {string}\n */\nexport function randomHanOrEn(len, zhProb = 0.5) {\n    len = Math.max(1, Math.floor(len));\n    const buf = [];\n    for (let i = 0; i < len; i++) {\n        buf.push(Math.random() < zhProb ? randomHan() : randomEnLetter());\n    }\n    return buf.join(\"\");\n}\n\n//#endregion\n\n//#region 防抖节流\n\n/**\n * 创建 debounced（防抖）函数。\n * - 默认 trailing 触发；当 `leading=true` 时，首次调用或超过等待间隔会立即执行。\n * - 支持手动取消。\n *\n * @template {(...args: any[]) => any} T\n * @param {T} fn - 要防抖的原始函数\n * @param {number} wait - 防抖等待时间（毫秒）\n * @param {boolean} [leading=false] - 是否启用立即执行（leading edge）\n * @returns {T & { cancel(): void }} 返回经过防抖包装的函数，并附带 `cancel` 方法\n * @throws {TypeError} 当 `fn` 不是函数时抛出\n */\nexport function debounce(fn, wait, leading = false) {\n    if (typeof fn !== \"function\") throw new TypeError(\"fn must be function\");\n    wait = Math.max(0, Number(wait) || 0);\n    let timeoutId;\n    let lastCall = 0; // 0 表示从未调用过\n\n    function debounced(...args) {\n        const isFirst = lastCall === 0;\n        const isOverWait = Date.now() - lastCall >= wait;\n\n        clearTimeout(timeoutId);\n\n        // 首次调用 || 已达到等待间隔\n        if (leading && (isFirst || isOverWait)) {\n            lastCall = Date.now();\n            return fn.apply(this, args);\n        }\n\n        timeoutId = setTimeout(() => {\n            lastCall = Date.now();\n            fn.apply(this, args);\n        }, wait);\n    }\n\n    debounced.cancel = () => {\n        clearTimeout(timeoutId);\n        lastCall = 0; // 恢复初始状态\n    };\n\n    return debounced;\n}\n\n/**\n * 创建 throttled（节流）函数。\n * 支持 leading/trailing 边缘触发，可手动取消。\n *\n * @template {(...args: any[]) => any} T\n * @param {T} fn - 要节流的原始函数\n * @param {number} wait - 节流间隔（毫秒）\n * @param {object} [options] - 配置项\n * @param {boolean} [options.leading=true] - 是否在 leading 边缘执行\n * @param {boolean} [options.trailing=true] - 是否在 trailing 边缘执行\n * @returns {T & { cancel(): void }} 返回经过节流包装的函数，并附带 `cancel` 方法\n * @throws {TypeError} 当 `fn` 不是函数时抛出\n */\nexport function throttle(fn, wait, { leading = true, trailing = true } = {}) {\n    if (typeof fn !== \"function\") throw new TypeError(\"fn must be function\");\n    wait = Math.max(0, Number(wait) || 0);\n\n    let timeoutId = null,\n        lastCall = 0;\n\n    function throttled(...args) {\n        const remaining = wait - (Date.now() - lastCall);\n\n        if (leading && (lastCall === 0 || remaining <= 0)) {\n            lastCall = Date.now();\n            fn.apply(this, args);\n        } else if (trailing && !timeoutId) {\n            timeoutId = setTimeout(\n                () => {\n                    timeoutId = null;\n                    lastCall = Date.now();\n                    fn.apply(this, args);\n                },\n                remaining > 0 ? remaining : wait\n            );\n        }\n    }\n\n    throttled.cancel = () => {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n        lastCall = 0;\n    };\n\n    return throttled;\n}\n\n//#endregion\n\n/**\n * 利用 JSON 序列化/反序列化实现**深拷贝**。\n * 注意：会丢失 `undefined`、函数、循环引用、特殊包装对象等。\n *\n * @template T\n * @param {T} obj - 待拷贝的 JSON 兼容值\n * @returns {T} 深拷贝后的值\n */\nexport function deepCloneByJSON(obj) {\n    return JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * **安全**地将源对象中**已存在**的属性赋值到目标对象。\n * 不会新增键，也不会复制原型链上的属性。\n *\n * @template {Record<PropertyKey, any>} T\n * @param {T} target - 目标对象（将被就地修改）\n * @param {...Partial<T>} sources - 一个或多个源对象\n * @returns {T} 修改后的目标对象（即第一个参数本身）\n *\n * @example\n * const defaults = { a: 1, b: 2 };\n * assignExisting(defaults, { a: 9, c: 99 }); // defaults 变为 { a: 9, b: 2 }\n */\nexport function assignExisting(target, ...sources) {\n    sources.forEach((source) => {\n        Object.keys(source).forEach((key) => {\n            if (target.hasOwnProperty(key)) {\n                target[key] = source[key];\n            }\n        });\n    });\n    return target;\n}\n\n/**\n * 提取任意函数（含箭头函数、普通函数、async、class 构造器）的形参名称列表。\n * 通过源码正则解析，不支持解构参数、默认参数、剩余参数等复杂语法；\n * 若出现上述场景将返回空数组或部分名称。\n *\n * @param {Function} fn - 目标函数\n * @returns {string[]} 按声明顺序排列的参数名数组；解析失败时返回空数组\n *\n * @example\n * getFunctionArgNames(function (a, b) {})        // [\"a\", \"b\"]\n * getFunctionArgNames((foo, bar) => {})          // [\"foo\", \"bar\"]\n * getFunctionArgNames(async function x({a} = {}) {}) // [] （解构无法识别）\n */\nexport function getFunctionArgNames(fn) {\n    const FN_ARG_SPLIT = /,/,\n        FN_ARG = /^\\s*(_?)(\\S+?)\\1\\s*$/,\n        FN_ARGS = /^[^(]*\\(\\s*([^)]*)\\)/m,\n        ARROW_ARG = /^([^(]+?)=>/,\n        STRIP_COMMENTS = /((\\/\\/.*$)|(\\/\\*[\\s\\S]*?\\*\\/))/gm;\n\n    const fnText = Function.prototype.toString.call(fn).replace(STRIP_COMMENTS, \"\");\n    const argDecl = fnText.match(ARROW_ARG) || fnText.match(FN_ARGS);\n    const retArgNames = [];\n    [].forEach.call(argDecl[1].split(FN_ARG_SPLIT), function (arg) {\n        arg.replace(FN_ARG, function (all, underscore, name) {\n            retArgNames.push(name);\n        });\n    });\n    return retArgNames;\n}\n\n/**\n * 将 Blob（或 File）读取为文本，并可选择自动执行 `JSON.parse`。\n * 当 `isParse=true` 且内容非法 JSON 时，会回退为返回原始文本。\n *\n * @param {Blob} blob - 待读取的 Blob/File 对象\n * @param {boolean} [isParse=true] - 是否尝试将结果按 JSON 解析\n * @returns {Promise<string | any>} 解析后的 JSON 对象或原始文本\n *\n * @example\n * const json = await readBlobAsText(blob);        // 自动 JSON.parse\n * const text = await readBlobAsText(blob, false); // 仅返回文本\n */\nexport function readBlobAsText(blob, isParse = true) {\n    return new Promise((resolve, reject) => {\n        const reader = new FileReader();\n        reader.onload = (evt) => {\n            const result = evt.target.result;\n            if (isParse) {\n                try {\n                    resolve(JSON.parse(result));\n                } catch (error) {\n                    console.error(error);\n                    resolve(result);\n                }\n            } else {\n                resolve(result);\n            }\n        };\n        reader.onerror = reject;\n        reader.readAsText(blob);\n    });\n}\n"],"names":[],"mappings":"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"}