sculp-js 1.5.1 → 1.7.0

package/lib/es/math.js

@@ -0,0 +1,82 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
+ * Released under the MIT License.
+ */
+
+/**
+ * 数值安全乘法
+ * @param arg1 数值1
+ * @param arg2 数值2
+ */
+const multiply = (arg1, arg2) => {
+    let m = 0;
+    const s1 = arg1.toString();
+    const s2 = arg2.toString();
+    if (s1.split('.')[1] !== undefined)
+        m += s1.split('.')[1].length;
+    if (s2.split('.')[1] !== undefined)
+        m += s2.split('.')[1].length;
+    return (Number(s1.replace('.', '')) * Number(s2.replace('.', ''))) / Math.pow(10, m);
+};
+/**
+ * 数值安全加法
+ * @param arg1 数值1
+ * @param arg2 数值2
+ */
+const add = (arg1, arg2) => {
+    let r1 = 0;
+    let r2 = 0;
+    let m = 0;
+    try {
+        r1 = arg1.toString().split('.')[1].length;
+    }
+    catch (e) {
+        r1 = 0;
+    }
+    try {
+        r2 = arg2.toString().split('.')[1].length;
+    }
+    catch (e) {
+        r2 = 0;
+    }
+    m = 10 ** Math.max(r1, r2);
+    return (multiply(arg1, m) + multiply(arg2, m)) / m;
+};
+/**
+ * 数值安全减法
+ * @param arg1 数值1
+ * @param arg2 数值2
+ */
+const subtract = (arg1, arg2) => add(arg1, -arg2);
+/**
+ * 数值安全除法
+ * @param arg1 数值1
+ * @param arg2 数值2
+ */
+const divide = (arg1, arg2) => {
+    let t1 = 0;
+    let t2 = 0;
+    let r1 = 0;
+    let r2 = 0;
+    if (arg1.toString().split('.')[1] !== undefined)
+        t1 = arg1.toString().split('.')[1].length;
+    if (arg2.toString().split('.')[1] !== undefined)
+        t2 = arg2.toString().split('.')[1].length;
+    r1 = Number(arg1.toString().replace('.', ''));
+    r2 = Number(arg2.toString().replace('.', ''));
+    return (r1 / r2) * Math.pow(10, t2 - t1);
+};
+/**
+ * Correct the given number to specifying significant digits.
+ *
+ * @param num The input number
+ * @param precision An integer specifying the number of significant digits
+ *
+ * @example strip(0.09999999999999998) === 0.1 // true
+ */
+function strip(num, precision = 15) {
+    return +parseFloat(Number(num).toPrecision(precision));
+}
+
+export { add, divide, multiply, strip, subtract };

package/lib/es/number.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/object.js

@@ -1,10 +1,10 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
-import { isObject, isUndefined, typeIs, isArray } from './type.js';
+import { isObject, objectHas, isNumber, isUndefined, typeIs, isArray } from './type.js';
 
 /**
  * 判断对象是否为纯对象
@@ -21,15 +21,6 @@ const isPlainObject = (obj) => {
     // 是否对象直接实例
     return proto === Object.prototype;
 };
-/**
- * 判断对象内是否有该静态属性
- * @param {object} obj
- * @param {string} key
- * @returns {boolean}
- */
-function objectHas(obj, key) {
-    return Object.prototype.hasOwnProperty.call(obj, key);
-}
 /**
  * 遍历对象，返回 false 中断遍历
  * @param {O} obj
@@ -183,23 +174,23 @@ function objectGet(obj, path, strict = false) {
     let i = 0;
     for (let len = keyArr.length; i < len - 1; ++i) {
         const key = keyArr[i];
-        if (key in tempObj) {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/no-unsafe-assignment
+        if (isNumber(Number(key)) && Array.isArray(tempObj)) {
+            tempObj = tempObj[key];
+        }
+        else if (isObject(tempObj) && objectHas(tempObj, key)) {
             tempObj = tempObj[key];
         }
         else {
             tempObj = undefined;
             if (strict) {
-                throw new Error('[berry/js-utils/object] objectGet path 路径不正确');
+                throw new Error('[Object] objectGet path 路径不正确');
             }
             break;
         }
     }
     return {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         p: tempObj,
         k: tempObj ? keyArr[i] : undefined,
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/no-unsafe-assignment
         v: tempObj ? tempObj[keyArr[i]] : undefined
     };
 }
@@ -227,4 +218,4 @@ function cloneDeep(obj, map = new WeakMap()) {
     return cloneObj;
 }
 
-export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick };
+export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectMap, objectAssign as objectMerge, objectOmit, objectPick };

package/lib/es/path.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/qs.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/random.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/string.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -123,7 +123,7 @@ const stringFill = (length, value = ' ') => new Array(length).fill(value).join('
 /**
  * 解析URL查询参数
  * @param {string} searchStr
- * @return {Record<string, string | string[]>}
+ * @returns {Record<string, string | string[]>}
  */
 function parseQueryParams(searchStr = location.search) {
     const queryObj = {};

package/lib/es/tooltip.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/tree.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -278,7 +278,7 @@ function formatTree(list, options = defaultFieldOptions) {
  * 树形结构转扁平化
  * @param {any} treeList
  * @param {IFieldOptions} options
- * @return {*}
+ * @returns {*}
  */
 function flatTree(treeList, options = defaultFieldOptions) {
     const { childField, keyField, pidField } = options;
@@ -304,7 +304,7 @@ function flatTree(treeList, options = defaultFieldOptions) {
  * @param {any[]} nodes
  * @param {string} query
  * @param {ISearchTreeOpts} options
- * @return {any[]}
+ * @returns {any[]}
  */
 function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
     const result = [];

package/lib/es/type.js

@@ -1,9 +1,34 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
+// 常用类型定义
+/**
+ * 判断对象内是否有该静态属性
+ * @param {object} obj
+ * @param {string} key
+ * @returns {boolean}
+ */
+function objectHas(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
+/**
+ * 判断一个对象是否为类数组
+ *
+ * @param any
+ * @returns {boolean}
+ */
+function arrayLike(any) {
+    if (isArray(any))
+        return true;
+    if (isString(any))
+        return true;
+    if (!isObject(any))
+        return false;
+    return objectHas(any, 'length');
+}
 /**
  * 判断任意值的数据类型
  * @param {unknown} any
@@ -39,7 +64,7 @@ const isRegExp = (any) => typeIs(any) === 'RegExp';
 /**
  * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
  * @param {string} str
- * @return {Object | boolean}
+ * @returns {Object | boolean}
  */
 function isJsonString(str) {
     try {
@@ -50,5 +75,43 @@ function isJsonString(str) {
         return false;
     }
 }
+/**
+ * Checks if `value` is an empty object, collection, map, or set.
+ *
+ * Objects are considered empty if they have no own enumerable string keyed
+ * properties.
+ *
+ * Array-like values such as `arguments` objects, arrays, buffers, strings, or
+ * jQuery-like collections are considered empty if they have a `length` of `0`.
+ * Similarly, maps and sets are considered empty if they have a `size` of `0`.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is empty, else `false`.
+ * @example
+ *
+ * isEmpty(null);
+ * // => true
+ *
+ * isEmpty(true);
+ * // => true
+ *
+ * isEmpty(1);
+ * // => true
+ *
+ * isEmpty([1, 2, 3]);
+ * // => false
+ *
+ * isEmpty({ 'a': 1 });
+ * // => false
+ */
+function isEmpty(value) {
+    if (isNullOrUnDef(value) || Number.isNaN(value)) {
+        return true;
+    }
+    if (arrayLike(value) && (isArray(value) || isString(value) || isFunction(value.splice))) {
+        return !value.length;
+    }
+    return !Object.keys(value).length;
+}
 
-export { typeIs as default, isArray, isBigInt, isBoolean, isDate, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs };
+export { arrayLike, typeIs as default, isArray, isBigInt, isBoolean, isDate, isEmpty, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, objectHas, typeIs };

package/lib/es/unique.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/url.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/validator.js

@@ -0,0 +1,130 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
+ * Released under the MIT License.
+ */
+
+// 邮箱
+const EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+/**
+ * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isEmail = (value) => EMAIL_REGEX.test(value);
+// 手机号码 (中国大陆)
+// reference: https://www.runoob.com/regexp/regexp-syntax.html (?: 是非捕获元之一)
+const PHONE_REGEX = /^(?:(?:\+|00)86)?1\d{10}$/;
+/**
+ * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isPhone = (value) => PHONE_REGEX.test(value);
+// 身份证号码
+// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/
+// ["北京市", "天津市", "河北省", "山西省", "内蒙古自治区",
+// "辽宁省", "吉林省", "黑龙江省",
+// "上海市", "江苏省", "浙江省", "安徽省", "福建省", "江西省", "山东省",
+// "河南省", "湖北省", "湖南省", "广东省", "广西壮族自治区", "海南省",
+// "重庆市", "四川省", "贵州省", "云南省", "西藏自治区",
+// "陕西省", "甘肃省", "青海省","宁夏回族自治区", "新疆维吾尔自治区",
+// "台湾省",
+// "香港特别行政区", "澳门特别行政区"]
+// ["11", "12", "13", "14", "15",
+// "21", "22", "23",
+// "31", "32", "33", "34", "35", "36", "37",
+// "41", "42", "43", "44", "45", "46",
+// "50", "51", "52", "53", "54",
+// "61", "62", "63", "64", "65",
+// "71",
+// "81", "82"]
+// 91 国外
+const IDNO_RE = /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\d{4}(18|19|20)\d{2}[01]\d[0123]\d{4}[\dxX]$/;
+/**
+ * 判断字符串是否为身份证号码格式
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isIdNo = (value) => {
+    const isSameFormat = IDNO_RE.test(value);
+    if (!isSameFormat)
+        return false;
+    const year = Number(value.slice(6, 10));
+    const month = Number(value.slice(10, 12));
+    const date = Number(value.slice(12, 14));
+    const d = new Date(year, month - 1, date);
+    const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;
+    if (!isSameDate)
+        return false;
+    // 将身份证号码前面的17位数分别乘以不同的系数；
+    // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2
+    // 将这17位数字和系数相乘的结果相加；
+    // 用加出来和除以11，看余数是多少；
+    // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；
+    // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2
+    // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。
+    const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+    const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
+    let sum = 0;
+    for (let start = 0; start < 17; start++) {
+        sum += Number(value.slice(start, start + 1)) * coefficientList[start];
+    }
+    return residueList[sum % 11] === value.slice(-1);
+};
+const URL_REGEX = /^(https?|ftp):\/\/([^\s/$.?#].[^\s]*)$/i;
+const HTTP_URL_REGEX = /^https?:\/\/([^\s/$.?#].[^\s]*)$/i;
+/**
+ * 判断字符串是否为 url 格式，支持 http、https、ftp 协议，支持域名或者 ipV4
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isUrl = (url, includeFtp = false) => {
+    const regex = includeFtp ? URL_REGEX : HTTP_URL_REGEX;
+    return regex.test(url);
+};
+// ipv4
+const IPV4_REGEX = /^(?:(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.){3}(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/;
+// ipv6
+const IPV6_REGEX = /^(([\da-fA-F]{1,4}:){7}[\da-fA-F]{1,4}|([\da-fA-F]{1,4}:){1,7}:|([\da-fA-F]{1,4}:){1,6}:[\da-fA-F]{1,4}|([\da-fA-F]{1,4}:){1,5}(:[\da-fA-F]{1,4}){1,2}|([\da-fA-F]{1,4}:){1,4}(:[\da-fA-F]{1,4}){1,3}|([\da-fA-F]{1,4}:){1,3}(:[\da-fA-F]{1,4}){1,4}|([\da-fA-F]{1,4}:){1,2}(:[\da-fA-F]{1,4}){1,5}|[\da-fA-F]{1,4}:((:[\da-fA-F]{1,4}){1,6})|:((:[\da-fA-F]{1,4}){1,7}|:)|fe80:(:[\da-fA-F]{0,4}){0,4}%[\da-zA-Z]+|::(ffff(:0{1,4})?:)?((25[0-5]|(2[0-4]|1?\d)?\d)\.){3}(25[0-5]|(2[0-4]|1?\d)?\d)|([\da-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1?\d)?\d)\.){3}(25[0-5]|(2[0-4]|1?\d)?\d))$/i;
+/**
+ * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isIpV4 = (value) => IPV4_REGEX.test(value);
+/**
+ * 判断字符串是否为 IPV6 格式，不对 ip 真实性做验证
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isIpV6 = (value) => IPV6_REGEX.test(value);
+const INTEGER_RE = /^(-?[1-9]\d*|0)$/;
+/**
+ * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isInteger = (value) => INTEGER_RE.test(value);
+const FLOAT_RE = /^-?([1-9]\d*|0)\.\d*[1-9]$/;
+/**
+ * 判断字符串是否为浮点数，即必须有小数点的有理数
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isFloat = (value) => FLOAT_RE.test(value);
+/**
+ * 判断字符串是否为正确数值，包括整数和浮点数
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isNumerical = (value) => isInteger(value) || isFloat(value);
+const DIGIT_RE = /^\d+$/;
+/**
+ * 判断字符串是否为数字，例如六位数字短信验证码（093031）
+ * @param {string} value
+ * @returns {boolean}
+ */
+const isDigit = (value) => DIGIT_RE.test(value);
+
+export { EMAIL_REGEX, HTTP_URL_REGEX, IPV4_REGEX, IPV6_REGEX, PHONE_REGEX, URL_REGEX, isDigit, isEmail, isFloat, isIdNo, isInteger, isIpV4, isIpV6, isNumerical, isPhone, isUrl };

package/lib/es/variable.js

@@ -0,0 +1,112 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
+ * Released under the MIT License.
+ */
+
+import { objectHas } from './type.js';
+
+/**
+ * 去除字符串中重复字符
+ * @param {string} str
+ * @returns string
+ * @example
+ *
+ * uniqueSymbol('1a1bac');
+ * // => '1abc'
+ */
+function uniqueSymbol(str) {
+    return [...new Set(str.trim().split(''))].join('');
+}
+/**
+ * 转义所有特殊字符
+ * @param {string} str 原字符串
+ *  reference: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Regular_expressions
+ * @returns string
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); //$&表示整个被匹配的字符串
+}
+/**
+ * 根据左右匹配符号生产解析变量(自动删除变量内的空白)
+ * @param {string} leftMatchSymbol
+ * @param {string} rightMatchSymbol
+ * @returns RegExp
+ */
+function parseVariableRegExp(leftMatchSymbol, rightMatchSymbol) {
+    return new RegExp(`${escapeRegExp(leftMatchSymbol.trim())}\\s*([^${escapeRegExp(uniqueSymbol(leftMatchSymbol))}${escapeRegExp(uniqueSymbol(rightMatchSymbol))}\\s]*)\\s*${rightMatchSymbol.trim()}`, 'g');
+}
+/**
+ * 解析字符串的插值变量
+ * @param {string} str 字符串
+ * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+ * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+ * @returns string[]
+ * @example
+ *
+ * default match symbol {} same as /{\s*([^{}\s]*)\s*}/g
+ */
+function parseVarFromString(str, leftMatchSymbol = '{', rightMatchSymbol = '}') {
+    return Array.from(str.matchAll(parseVariableRegExp(leftMatchSymbol, rightMatchSymbol))).map(el => el?.[1]);
+}
+/**
+ * 替换字符串中的插值变量
+ * @param {string} sourceStr
+ * @param {Record<string, any>} targetObj
+ * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+ * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+ * @returns string
+ */
+function replaceVarFromString(sourceStr, targetObj, leftMatchSymbol = '{', rightMatchSymbol = '}') {
+    return sourceStr.replace(new RegExp(parseVariableRegExp(leftMatchSymbol, rightMatchSymbol)), function (m, p1) {
+        return objectHas(targetObj, p1) ? targetObj[p1] : m;
+    });
+}
+/**
+ * 在指定作用域中执行代码
+ * @param {string} code 要执行的代码（需包含 return 语句或表达式）
+ * @param {Object} scope 作用域对象（键值对形式的变量环境）
+ * @returns 代码执行结果
+ *
+ * @example
+ * // 测试用例 1: 基本变量访问
+ * executeInScope("return a + b;", { a: 1, b: 2 });
+ * // 3
+ *
+ * // 测试用例 2: 支持复杂表达式和运算
+ * executeInScope(
+ * "return Array.from({ length: 3 }, (_, i) => base + i);",
+ * { base: 100 }
+ * );
+ * // [100, 101, 102]
+ *
+ * // 支持外传函数作用域执行
+ * const scope = {
+ *  $: {
+ *    fun: {
+ *      time: {
+ *        now: function () {
+ *          return new Date();
+ *        },
+ *      },
+ *    },
+ *  },
+ * };
+ * executeInScope("return $.fun.time.now()", scope)
+ */
+function executeInScope(code, scope = {}) {
+    // 提取作用域对象的键和值
+    const keys = Object.keys(scope);
+    const values = keys.map(key => scope[key]);
+    try {
+        // 动态创建函数，将作用域的键作为参数，代码作为函数体
+        const func = new Function(...keys, `return (() => { ${code} })()`);
+        // 调用函数并传入作用域的值
+        return func(...values);
+    }
+    catch (error) {
+        throw new Error(`代码执行失败: ${error.message}`);
+    }
+}
+
+export { escapeRegExp, executeInScope, parseVarFromString, replaceVarFromString, uniqueSymbol };

package/lib/es/watermark.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/es/we-decode.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -10,7 +10,7 @@ const b64re = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3
 /**
  * 字符串编码成Base64 （适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 function weBtoa(string) {
     // 同window.btoa: 字符串编码成Base64
@@ -32,7 +32,7 @@ function weBtoa(string) {
 /**
  * Base64解码为原始字符串（适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 function weAtob(string) {
     // 同window.atob: Base64解码为原始字符串