util-helpers 4.12.7 → 4.12.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/dist/util-helpers.js +2 -1
  2. package/dist/util-helpers.js.map +1 -1
  3. package/dist/util-helpers.min.js +1 -1
  4. package/dist/util-helpers.min.js.map +1 -1
  5. package/esm/utils/config.js +2 -1
  6. package/lib/utils/config.js +2 -1
  7. package/package.json +3 -3
  8. package/types/bytesToSize.d.ts +4 -10
  9. package/types/dataURLToBlob.d.ts +1 -1
  10. package/types/divide.d.ts +9 -8
  11. package/types/formatBankCard.d.ts +4 -8
  12. package/types/formatMobile.d.ts +9 -7
  13. package/types/formatMoney.d.ts +8 -14
  14. package/types/index.d.ts +1 -1
  15. package/types/isBankCard.d.ts +5 -10
  16. package/types/isBusinessLicense.d.ts +6 -9
  17. package/types/isChinese.d.ts +9 -16
  18. package/types/isEmail.d.ts +2 -5
  19. package/types/isHMCard.d.ts +8 -8
  20. package/types/isIPv4.d.ts +4 -11
  21. package/types/isIPv6.d.ts +11 -29
  22. package/types/isIdCard.d.ts +8 -11
  23. package/types/isMobile.d.ts +2 -5
  24. package/types/isPassport.d.ts +2 -5
  25. package/types/isPassword.d.ts +10 -17
  26. package/types/isPostcode.d.ts +2 -5
  27. package/types/isPromiseLike.d.ts +3 -7
  28. package/types/isQQ.d.ts +2 -5
  29. package/types/isSocialCreditCode.d.ts +6 -11
  30. package/types/isSwiftCode.d.ts +5 -5
  31. package/types/isTWCard.d.ts +7 -4
  32. package/types/isTelephone.d.ts +6 -9
  33. package/types/isUrl.d.ts +7 -19
  34. package/types/isVehicle.d.ts +8 -13
  35. package/types/isWX.d.ts +2 -5
  36. package/types/minus.d.ts +4 -8
  37. package/types/normalizeString.d.ts +2 -0
  38. package/types/numberToChinese.d.ts +10 -18
  39. package/types/padZero.d.ts +9 -8
  40. package/types/parseIdCard.d.ts +3 -3
  41. package/types/plus.d.ts +4 -8
  42. package/types/randomString.d.ts +2 -0
  43. package/types/replaceChar.d.ts +9 -17
  44. package/types/round.d.ts +3 -7
  45. package/types/safeDate.d.ts +2 -0
  46. package/types/setDataURLPrefix.d.ts +2 -0
  47. package/types/times.d.ts +4 -8
  48. package/types/utils/config.d.ts +2 -0
  49. package/types/utils/math.util.d.ts +4 -4
  50. package/types/waitTime.d.ts +3 -1
  51. package/types/src/blobToDataURL.d.ts +0 -25
  52. package/types/src/bytesToSize.d.ts +0 -18
  53. package/types/src/calculateCursorPosition.d.ts +0 -26
  54. package/types/src/dataURLToBlob.d.ts +0 -15
  55. package/types/src/divide.d.ts +0 -22
  56. package/types/src/formatBankCard.d.ts +0 -31
  57. package/types/src/formatMobile.d.ts +0 -29
  58. package/types/src/formatMoney.d.ts +0 -44
  59. package/types/src/index.d.ts +0 -45
  60. package/types/src/isBankCard.d.ts +0 -27
  61. package/types/src/isBusinessLicense.d.ts +0 -26
  62. package/types/src/isChinese.d.ts +0 -34
  63. package/types/src/isEmail.d.ts +0 -16
  64. package/types/src/isHMCard.d.ts +0 -24
  65. package/types/src/isIPv4.d.ts +0 -18
  66. package/types/src/isIPv6.d.ts +0 -32
  67. package/types/src/isIdCard.d.ts +0 -31
  68. package/types/src/isMobile.d.ts +0 -16
  69. package/types/src/isPassport.d.ts +0 -18
  70. package/types/src/isPassword.d.ts +0 -39
  71. package/types/src/isPostcode.d.ts +0 -16
  72. package/types/src/isPromiseLike.d.ts +0 -17
  73. package/types/src/isQQ.d.ts +0 -16
  74. package/types/src/isSocialCreditCode.d.ts +0 -26
  75. package/types/src/isSwiftCode.d.ts +0 -22
  76. package/types/src/isTWCard.d.ts +0 -26
  77. package/types/src/isTelephone.d.ts +0 -22
  78. package/types/src/isUrl.d.ts +0 -22
  79. package/types/src/isVehicle.d.ts +0 -24
  80. package/types/src/isWX.d.ts +0 -16
  81. package/types/src/minus.d.ts +0 -17
  82. package/types/src/normalizeString.d.ts +0 -24
  83. package/types/src/numberToChinese.d.ts +0 -49
  84. package/types/src/padZero.d.ts +0 -25
  85. package/types/src/parseIdCard.d.ts +0 -107
  86. package/types/src/plus.d.ts +0 -17
  87. package/types/src/randomString.d.ts +0 -21
  88. package/types/src/replaceChar.d.ts +0 -46
  89. package/types/src/round.d.ts +0 -18
  90. package/types/src/safeDate.d.ts +0 -24
  91. package/types/src/setDataURLPrefix.d.ts +0 -26
  92. package/types/src/strlen.d.ts +0 -20
  93. package/types/src/times.d.ts +0 -17
  94. package/types/src/utils/config.d.ts +0 -13
  95. package/types/src/utils/constants.d.ts +0 -2
  96. package/types/src/utils/convertToString.d.ts +0 -8
  97. package/types/src/utils/devWarn.d.ts +0 -7
  98. package/types/src/utils/math.util.d.ts +0 -63
  99. package/types/src/utils/type/index.d.ts +0 -19
  100. package/types/src/utils/type/isArguments.d.ts +0 -18
  101. package/types/src/utils/type/isArray.d.ts +0 -18
  102. package/types/src/utils/type/isBoolean.d.ts +0 -18
  103. package/types/src/utils/type/isDate.d.ts +0 -18
  104. package/types/src/utils/type/isError.d.ts +0 -18
  105. package/types/src/utils/type/isFunction.d.ts +0 -18
  106. package/types/src/utils/type/isMap.d.ts +0 -18
  107. package/types/src/utils/type/isNaN.d.ts +0 -18
  108. package/types/src/utils/type/isNil.d.ts +0 -11
  109. package/types/src/utils/type/isNull.d.ts +0 -18
  110. package/types/src/utils/type/isNumber.d.ts +0 -27
  111. package/types/src/utils/type/isObject.d.ts +0 -21
  112. package/types/src/utils/type/isRegExp.d.ts +0 -18
  113. package/types/src/utils/type/isSet.d.ts +0 -18
  114. package/types/src/utils/type/isString.d.ts +0 -18
  115. package/types/src/utils/type/isSymbol.d.ts +0 -18
  116. package/types/src/utils/type/isType.d.ts +0 -11
  117. package/types/src/utils/type/isUndefined.d.ts +0 -21
  118. package/types/src/utils/type/isWeakMap.d.ts +0 -18
  119. package/types/src/utils/type/isWeakSet.d.ts +0 -18
  120. package/types/src/validatePassword.d.ts +0 -134
  121. package/types/src/waitTime.d.ts +0 -22
package/types/isUrl.d.ts CHANGED
@@ -10,25 +10,13 @@ export default isUrl;
10
10
  * @returns {boolean} 值是否为url
11
11
  * @example
12
12
  *
13
- * isUrl('');
14
- * // => false
13
+ * isUrl(''); // false
14
+ * isUrl('8.8.8.8'); // false
15
+ * isUrl('example.com'); // true
16
+ * isUrl('http://example.com'); // true
17
+ * isUrl('https://example.com:8080'); // true
18
+ * isUrl('http://www.example.com/test/123'); // true
19
+ * isUrl('http://www.example.com/test/123?foo=bar'); // true
15
20
  *
16
- * isUrl('8.8.8.8');
17
- * // => false
18
- *
19
- * isUrl('example.com');
20
- * // => true
21
- *
22
- * isUrl('http://example.com');
23
- * // => true
24
- *
25
- * isUrl('https://example.com:8080');
26
- * // => true
27
- *
28
- * isUrl('http://www.example.com/test/123');
29
- * // => true
30
- *
31
- * isUrl('http://www.example.com/test/123?foo=bar');
32
- * // => true
33
21
  */
34
22
  declare function isUrl(value: any): boolean;
@@ -10,20 +10,15 @@ export default isVehicle;
10
10
  * @returns {boolean} 值是否为车牌号
11
11
  * @example
12
12
  *
13
- * isVehicle('京L12345');
14
- * // => true
13
+ * isVehicle('京L12345'); // true
14
+ * isVehicle('京L1234学'); // true
15
+ * isVehicle('BL1234警'); // true
15
16
  *
16
- * isVehicle('粤BD12345');
17
- * // => true
18
- *
19
- * isVehicle('粤BF12345');
20
- * // => true
21
- *
22
- * isVehicle('粤B12345D');
23
- * // => true
24
- *
25
- * isVehicle('粤B12345F');
26
- * // => true
17
+ * // 新能源车牌
18
+ * isVehicle('粤BD12345'); // true
19
+ * isVehicle('粤BF12345'); // true
20
+ * isVehicle('粤B12345D'); // true
21
+ * isVehicle('粤B12345F'); // true
27
22
  *
28
23
  */
29
24
  declare function isVehicle(value: any): boolean;
package/types/isWX.d.ts CHANGED
@@ -9,11 +9,8 @@ export default isWX;
9
9
  * @returns {boolean} 值是否为微信号
10
10
  * @example
11
11
  *
12
- * isWX('a12345');
13
- * // => true
14
- *
15
- * isWX('123');
16
- * // => false
12
+ * isWX('a12345'); // true
13
+ * isWX('123'); // false
17
14
  *
18
15
  */
19
16
  declare function isWX(value: any): boolean;
package/types/minus.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  export default minus;
2
2
  /**
3
- * 精确减法,支持多个数相减
3
+ * 精确减法,支持多个数相减,减数默认为 0 。
4
4
  *
5
5
  * @static
6
6
  * @alias module:Math.minus
@@ -9,13 +9,9 @@ export default minus;
9
9
  * @returns {number} 差
10
10
  * @example
11
11
  *
12
- * minus(1, 0.9);
13
- * // => 0.1
12
+ * minus(1, 0.9); // 0.1
13
+ * minus(1, 0.9, 0.02); // 0.08
14
+ * minus(1, 0.9, 0.02, 0.08); // 0
14
15
  *
15
- * minus(1, 0.9, 0.02);
16
- * // => 0.08
17
- *
18
- * minus(1, 0.9, 0.02, 0.08);
19
- * // => 0
20
16
  */
21
17
  declare function minus(...nums: (number | string)[]): number;
@@ -9,6 +9,7 @@ export default normalizeString;
9
9
  * @param {*} value 待处理的值
10
10
  * @returns {string} 规整化的值
11
11
  * @example
12
+ *
12
13
  * normalizeString(); // ''
13
14
  * normalizeString(undefined); // ''
14
15
  * normalizeString(void 0); // ''
@@ -18,5 +19,6 @@ export default normalizeString;
18
19
  * normalizeString(NaN); // 'NaN'
19
20
  * normalizeString(1); // '1'
20
21
  * normalizeString('a'); // 'a'
22
+ *
21
23
  */
22
24
  declare function normalizeString(value: any): string;
@@ -10,7 +10,7 @@ export default numberToChinese;
10
10
  * @param {Object} [options] 配置项
11
11
  * @param {boolean} [options.big5=false] 繁体
12
12
  * @param {boolean} [options.unit=true] 计数单位
13
- * @param {string} [options.decimal="点"] 中文小数点
13
+ * @param {string} [options.decimal="点"] 中文小数点,繁体字为點
14
14
  * @param {string} [options.zero="零"] 设置0。常用配置 〇
15
15
  * @param {string} [options.negative="负"] 负数前面的字
16
16
  * @param {Object} [options.unitConfig] 节点单位配置
@@ -19,29 +19,21 @@ export default numberToChinese;
19
19
  * @returns {string} 中文数字
20
20
  * @example
21
21
  *
22
- * numberToChinese(100);
23
- * // => 一百
24
- *
25
- * numberToChinese(100.3);
26
- * // => 一百点三
22
+ * numberToChinese(100); // 一百
23
+ * numberToChinese(100.3); // 一百点三
24
+ * numberToChinese(1234567890); // 一十二亿三千四百五十六万七千八百九十
25
+ * numberToChinese(1234567890.11); // 一十二亿三千四百五十六万七千八百九十点一一
27
26
  *
28
27
  * // 繁体
29
- * numberToChinese(100, {big5: true});
30
- * // => 壹佰
31
- *
32
- * numberToChinese(100.3, {big5: true});
33
- * // => 壹佰点叁
34
- *
35
- * numberToChinese(1234567890, {big5: true});
36
- * // => 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾
28
+ * numberToChinese(100, {big5: true}); // 壹佰
29
+ * numberToChinese(100.3, {big5: true}); // 壹佰點叁
30
+ * numberToChinese(1234567890.11, {big5: true}); // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾點壹壹
37
31
  *
38
32
  * // 不带计数单位
39
- * numberToChinese(1990, {unit: false});
40
- * // => 一九九零
33
+ * numberToChinese(1990, {unit: false}); // 一九九零
41
34
  *
42
35
  * // 不带计数单位,修改0
43
- * numberToChinese(1990, {unit: false, zero:'〇'});
44
- * // => 一九九〇
36
+ * numberToChinese(1990, {unit: false, zero:'〇'}); // 一九九〇
45
37
  *
46
38
  */
47
39
  declare function numberToChinese(num: number, { big5, unit, decimal, zero, negative, unitConfig }?: {
@@ -9,16 +9,17 @@ export default padZero;
9
9
  * @param {number} [size=2] 指定字符串长度
10
10
  * @returns {string} 用零填充数字到给定长度的字符串
11
11
  * @example
12
- * padZero(5); // '05'
13
- * padZero('5'); // '05'
12
+ * padZero(5); // 05
13
+ * padZero('5'); // 05
14
14
  *
15
- * padZero(12); // '12'
16
- * padZero('12'); // '12'
15
+ * padZero(12); // 12
16
+ * padZero('12'); // 12
17
17
  *
18
- * padZero(688); // '688'
19
- * padZero('688'); // '688'
18
+ * padZero(688); // 688
19
+ * padZero('688'); // 688
20
+ *
21
+ * padZero(688, 5); // 00688
22
+ * padZero('688', 5); // 00688
20
23
  *
21
- * padZero(688, 5); // '00688'
22
- * padZero('688', 5); // '00688'
23
24
  */
24
25
  declare function padZero(value: string | number, size?: number | undefined): string;
@@ -80,11 +80,11 @@ export type IdCardInfo = {
80
80
  * @param {string} id 身份证号码,支持15位
81
81
  * @returns {null|IdCardInfo} null 或 省份、生日、性别,省/市/区/年/月/日/性别编码
82
82
  * @example
83
- * parseIdCard('123456789123456');
84
- * // => null
83
+ *
84
+ * parseIdCard('123456789123456'); // null
85
85
  *
86
86
  * // 18位身份证号码
87
- * parseIdCard('130701199310302288')
87
+ * parseIdCard('130701199310302288');
88
88
  * // =>
89
89
  * {
90
90
  * birthday: "1993-10-30",
package/types/plus.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  export default plus;
2
2
  /**
3
- * 精确加法,支持多个数相加
3
+ * 精确加法,支持多个数相加,加数默认为 0 。
4
4
  *
5
5
  * @static
6
6
  * @alias module:Math.plus
@@ -9,13 +9,9 @@ export default plus;
9
9
  * @returns {number} 总和
10
10
  * @example
11
11
  *
12
- * plus(0.1, 0.2);
13
- * // => 0.3
12
+ * plus(0.1, 0.2); // 0.3
13
+ * plus(0.1, 0.2, 0.3); // 0.6
14
+ * plus(0.1, 0.2, 0.3, 0.4); // 1
14
15
  *
15
- * plus(0.1, 0.2, 0.3);
16
- * // => 0.6
17
- *
18
- * plus(0.1, 0.2, 0.3, 0.4);
19
- * // => 1
20
16
  */
21
17
  declare function plus(...nums: (number | string)[]): number;
@@ -9,11 +9,13 @@ export default randomString;
9
9
  * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符,默认为数字和大小写字母
10
10
  * @returns {string} 随机字符串
11
11
  * @example
12
+ *
12
13
  * randomString(5); // slk23
13
14
  * randomString(8); // 71mHqo2A
14
15
  *
15
16
  * // 自定义允许的字符
16
17
  * randomString(5, 'abc'); // ccbcb
17
18
  * randomString(8, 'abcefg'); // bcgcfabg
19
+ *
18
20
  */
19
21
  declare function randomString(len?: number | undefined, optionalChars?: string | undefined): string;
@@ -16,33 +16,25 @@ export default replaceChar;
16
16
  * @example
17
17
  *
18
18
  * // 手机号
19
- * replaceChar('13000000000');
20
- * // => 130****0000
19
+ * replaceChar('13000000000'); // 130****0000
21
20
  *
22
21
  * // 身份证
23
- * replaceChar('130701199310302288');
24
- * // => 130***********2288
22
+ * replaceChar('130701199310302288'); // 130***********2288
25
23
  *
26
24
  * // 邮箱
27
25
  * const email = '12345@qq.com'
28
- * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4});
29
- * // => 12****@qq.com
26
+ * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4}); // 12****@qq.com
30
27
  *
31
28
  * // 银行卡号
32
- * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4});
33
- * // => ****0018
29
+ * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4}); // ****0018
34
30
  *
35
- * // 带格式的银行卡号
36
- * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '});
37
- * // => 6228 **** **** **** 018
31
+ * // 带格式的银行卡号,忽略空字符串
32
+ * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '}); // 6228 **** **** **** 018
38
33
  *
39
34
  * // 用户名
40
- * replaceChar('林某某', {start: 1, end: Infinity, repeat: 2});
41
- * // => 林**
42
- * replaceChar('林某', {start: 1, end: Infinity, repeat: 2});
43
- * // => 林**
44
- * replaceChar('林某某某', {start: 1, end: Infinity, repeat: 2});
45
- * // => 林**
35
+ * replaceChar('林某某', {start: 1, end: Infinity, repeat: 2}); // 林**
36
+ * replaceChar('林某', {start: 1, end: Infinity, repeat: 2}); // 林**
37
+ * replaceChar('林某某某', {start: 1, end: Infinity, repeat: 2}); // 林**
46
38
  *
47
39
  */
48
40
  declare function replaceChar(str: string, { start, end, char, repeat, exclude }?: {
package/types/round.d.ts CHANGED
@@ -10,13 +10,9 @@ export default round;
10
10
  * @returns {number} 四舍五入的数字
11
11
  * @example
12
12
  *
13
- * round(4.006);
14
- * // => 4
13
+ * round(4.006); // 4
14
+ * round(4.006, 2); // 4.01
15
+ * round(4060, -2); // 4100
15
16
  *
16
- * round(4.006, 2);
17
- * // => 4.01
18
- *
19
- * round(4060, -2);
20
- * // => 4100
21
17
  */
22
18
  declare function round(num: number | string, precision?: number | undefined): number;
@@ -11,6 +11,7 @@ export default safeDate;
11
11
  * @param {...number} args 月/日/时/分/秒/毫秒
12
12
  * @returns {Date} Date 实例日期对象
13
13
  * @example
14
+ *
14
15
  * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
15
16
  * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
16
17
  * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
@@ -18,5 +19,6 @@ export default safeDate;
18
19
  * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
19
20
  * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
20
21
  *
22
+ *
21
23
  */
22
24
  declare function safeDate(value?: string | number | Date | undefined, ...args: number[]): Date;
@@ -13,6 +13,7 @@ export default setDataURLPrefix;
13
13
  * @param {boolean} [base64=true] 添加 base64 标识
14
14
  * @returns {string} DataURL 格式的字符串
15
15
  * @example
16
+ *
16
17
  * const data = 'PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
17
18
  * setDataURLPrefix(data); // data:image/png;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
18
19
  * setDataURLPrefix(data, 'image/png', false); // data:image/png,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
@@ -20,5 +21,6 @@ export default setDataURLPrefix;
20
21
  * setDataURLPrefix(data, 'text/html'); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
21
22
  * setDataURLPrefix(data, ''); // data:;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
22
23
  * setDataURLPrefix(data, '', false); // data:,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
24
+ *
23
25
  */
24
26
  declare function setDataURLPrefix(data: string, mimetype?: string | undefined, base64?: boolean | undefined): string;
package/types/times.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  export default times;
2
2
  /**
3
- * 精确乘法,支持多个数相乘
3
+ * 精确乘法,支持多个数相乘,乘数默认为 1 。
4
4
  *
5
5
  * @static
6
6
  * @alias module:Math.times
@@ -9,13 +9,9 @@ export default times;
9
9
  * @returns {number} 乘积
10
10
  * @example
11
11
  *
12
- * times(3, 0.6);
13
- * // => 1.8
12
+ * times(3, 0.6); // 1.8
13
+ * times(3, 0.6, 2); // 3.6
14
+ * times(3, 0.6, 2, 10); // 36
14
15
  *
15
- * times(3, 0.6, 2);
16
- * // => 3.6
17
- *
18
- * times(3, 0.6, 2, 10);
19
- * // => 36
20
16
  */
21
17
  declare function times(...nums: (number | string)[]): number;
@@ -9,3 +9,5 @@ export namespace config {
9
9
  * @param {boolean} bool 是否禁止warning提示
10
10
  */
11
11
  export function setDisableWarning(bool: boolean): void;
12
+ import { version } from "../../package.json";
13
+ export { version };
@@ -1,10 +1,10 @@
1
1
  /**
2
- * 值是否为有效的数值
2
+ * 将值转换为有效数值
3
3
  *
4
- * @param {*} value 待检测的值
5
- * @returns {boolean} 是否为有效的数值
4
+ * @param {*} value 要转换的值
5
+ * @returns {number|string} 有效数值
6
6
  */
7
- export function isEffectiveNumeric(value: any): boolean;
7
+ export function transformEffectiveNumber(value: any): number | string;
8
8
  /**
9
9
  * 是否为科学计数法数字
10
10
  *
@@ -8,6 +8,7 @@ export default waitTime;
8
8
  * @param {number} [time=1000] 延时时间,单位毫秒
9
9
  * @returns {Promise<void>}
10
10
  * @example
11
+ *
11
12
  * const test = async ()=>{
12
13
  * await waitTime();
13
14
  * // do something
@@ -15,6 +16,7 @@ export default waitTime;
15
16
  *
16
17
  * waitTime(500).then(()=>{
17
18
  * // do something
18
- * })
19
+ * });
20
+ *
19
21
  */
20
22
  declare function waitTime(time?: number | undefined): Promise<void>;
@@ -1,25 +0,0 @@
1
- export default blobToDataURL;
2
- /**
3
- * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串。
4
- *
5
- * @static
6
- * @alias module:Processor.blobToDataURL
7
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
8
- * @since 4.1.0
9
- * @param {Blob} blob Blob 或 File 对象
10
- * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
11
- * @example
12
- * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
13
- * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
14
- *
15
- * blobToDataURL(htmlBlob).then(data=>{
16
- * console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
17
- * });
18
- *
19
- * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
20
- *
21
- * blobToDataURL(textBlob).then(data=>{
22
- * console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
23
- * });
24
- */
25
- declare function blobToDataURL(blob: Blob): Promise<string>;
@@ -1,18 +0,0 @@
1
- export default bytesToSize;
2
- /**
3
- * 字节转换存储单位,保留2位小数点
4
- *
5
- * @static
6
- * @alias module:Processor.bytesToSize
7
- * @since 3.8.0
8
- * @param {number} bytes 字节大小
9
- * @returns {string} 存储单位值
10
- * @example
11
- *
12
- * bytesToSize(0); // 0 B
13
- * bytesToSize(1024); // 1 KB
14
- * bytesToSize(3.213243*1024*1024); // 3.21 MB
15
- * bytesToSize(1024*1024*1024); // 1 GB
16
- *
17
- */
18
- declare function bytesToSize(bytes: number): string;
@@ -1,26 +0,0 @@
1
- export default calculateCursorPosition;
2
- /**
3
- * 计算输入框的值格式化后光标位置
4
- *
5
- * @static
6
- * @alias module:Other.calculateCursorPosition
7
- * @since 4.6.0
8
- * @see 格式化手机号码 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile|formatMobile}
9
- * @see 格式化银行卡号 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard|formatBankCard}
10
- * @see h5示例 {@link https://2950v9.csb.app/|点击查看}
11
- * @see react示例 {@link https://33ccy9.csb.app/|点击查看}
12
- * @param {number} prevPos 赋值前的光标位置,onChange/onInput的光标位置 e.target.selectionEnd
13
- * @param {string} prevCtrlValue 上一个格式化后的值
14
- * @param {string} rawValue 当前输入原值
15
- * @param {string} ctrlValue 当前格式化后的值
16
- * @param {Object} [options] 配置项
17
- * @param {string[]|string} [options.placeholderChar=' '] 占位符
18
- * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字,意味着 ctrlValue 需要去掉非数字。
19
- * @param {'mobile'|'bankCard'} [options.type] 格式化类型,内置手机号码和银行卡号特殊处理
20
- * @returns {number} 格式化后的光标位置
21
- */
22
- declare function calculateCursorPosition(prevPos: number, prevCtrlValue: string, rawValue: string, ctrlValue: string, { placeholderChar, maskReg, type }?: {
23
- placeholderChar?: string | string[] | undefined;
24
- maskReg?: RegExp | undefined;
25
- type?: "mobile" | "bankCard" | undefined;
26
- } | undefined): number;
@@ -1,15 +0,0 @@
1
- export default dataURLToBlob;
2
- /**
3
- * 将 DataURL 转为 Blob 对象
4
- *
5
- * @static
6
- * @alias module:Processor.dataURLToBlob
7
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
8
- * @since 4.1.0
9
- * @param {string} dataurl data: 协议的URL
10
- * @returns {Blob} Blob 对象
11
- * @example
12
- * const dataurl = 'data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
13
- * dataURLToBlob(dataurl); // Blob {size: 32, type: 'text/html'}
14
- */
15
- declare function dataURLToBlob(dataurl: string): Blob;
@@ -1,22 +0,0 @@
1
- export default divide;
2
- /**
3
- * 精确除法,支持多个数相除,除数默认为 1 。
4
- *
5
- * @static
6
- * @alias module:Math.divide
7
- * @since 3.1.0
8
- * @param {...number|string} nums 被除数和除数
9
- * @returns {number} 商数
10
- * @example
11
- *
12
- * divide(1.21); // 1.21 除数默认为 1 ,即 1.21/1 = 1.21
13
- * divide(1.21, 1.1); // 1.1
14
- * divide(1000, 10, 10); // 10
15
- * divide(1000, 10, 10, 10); // 1
16
- *
17
- * divide(); // NaN 如果没有传入参数,被除数默认为 undefined 。 Number(undefined) 转换为 NaN ,NaN/1 = NaN
18
- * divide(null); // 0 Number(null) 转换为 0 , 0/1 = 0
19
- * divide('1.5 ', 0.5); // 3 Number('1.5 ') 转换为 1.5 ,1.5/0.5 = 3
20
- *
21
- */
22
- declare function divide(...nums: (number | string)[]): number;
@@ -1,31 +0,0 @@
1
- export default formatBankCard;
2
- /**
3
- * 格式化银行卡号
4
- *
5
- * @static
6
- * @alias module:Processor.formatBankCard
7
- * @since 1.1.0
8
- * @param {string} bankCardNo 要处理的字符串
9
- * @param {Object} [options] 配置项
10
- * @param {string} [options.char=" "] 间隔字符
11
- * @param {number} [options.length=4] 间隔长度
12
- * @returns {string} 格式化的银行卡号
13
- * @example
14
- *
15
- * // 19位银行卡
16
- * formatBankCard('6228480402564890018'); // 6228 4804 0256 4890 018
17
- *
18
- * // 16位银行卡
19
- * formatBankCard('6228480402564890'); // 6228 4804 0256 4890
20
- *
21
- * // 脱敏银行卡
22
- * formatBankCard('6228********890'); // 6228 **** **** 890
23
- *
24
- * // 16位银行卡,"-"间隔
25
- * formatBankCard('6228480402564890', {char: '-'}); // 6228-4804-0256-4890
26
- *
27
- */
28
- declare function formatBankCard(bankCardNo?: string, { char, length }?: {
29
- char?: string | undefined;
30
- length?: number | undefined;
31
- } | undefined): string;
@@ -1,29 +0,0 @@
1
- export default formatMobile;
2
- /**
3
- * 格式化手机号码
4
- *
5
- * @static
6
- * @alias module:Processor.formatMobile
7
- * @since 4.5.0
8
- * @param {string} mobileNo 手机号码
9
- * @param {object} [options] 配置项
10
- * @param {string} [options.char=' '] 间隔字符
11
- * @returns {string} 格式化后的手机号码
12
- * @example
13
- *
14
- * formatMobile('13345678900'); // 133 4567 8900
15
- * formatMobile('13345678900', { char: '-' }); // 133-4567-8900
16
- *
17
- * // 脱敏手机号码
18
- * formatMobile('133****1234'); // 133 **** 1234
19
- * formatMobile('133****1234', { char: '-' }); // 133-****-1234
20
- *
21
- * // 手机号码位数不够
22
- * formatMobile('133'); // 133
23
- * formatMobile('133456'); // 133 456
24
- * formatMobile('13345678'); // 133 4567 8
25
- *
26
- */
27
- declare function formatMobile(mobileNo: string, { char }?: {
28
- char?: string | undefined;
29
- } | undefined): string;
@@ -1,44 +0,0 @@
1
- export default formatMoney;
2
- /**
3
- * 格式化金额
4
- *
5
- * @static
6
- * @alias module:Processor.formatMoney
7
- * @since 1.1.0
8
- * @param {string | number} num 需转换金额 (最大:9007199254740991 最小: -9007199254740991)
9
- * @param {Object} [options] - 金额格式化配置
10
- * @param {string | number} [options.precision=2] - 保留位数 (最高:10位)
11
- * @param {string} [options.symbol] - 货币符号
12
- * @param {string} [options.thousand=","] - 千分位符号
13
- * @param {string} [options.decimal="."] - 小数位符号
14
- * @returns {string} 格式化的金额
15
- * @example
16
- *
17
- * // 整数
18
- * formatMoney('1000'); // 1,000.00
19
- *
20
- * // 小数(默认保留2位小数)
21
- * formatMoney('3000.03'); // 3,000.03
22
- *
23
- * // 保留4位小数
24
- * formatMoney('3000.0300', { precision: 4 }); // 3,000.0300
25
- *
26
- * // 保留10位小数
27
- * formatMoney('1500.2', { precision: 10 }); // 1,500.2000000000
28
- *
29
- * // 自定义单位符号
30
- * formatMoney(1000.00, { symbol: '$' }); // $1,000.00
31
- *
32
- * // 自定义千位分割符(默认',')
33
- * formatMoney(1000.00, { thousand: '|' }); // 1|000.00
34
- *
35
- * // 自定义小数位分割符(默认'.')
36
- * formatMoney(1000.00, { decimal: '&' }); // 1,000&00
37
- *
38
- */
39
- declare function formatMoney(num: string | number, { precision, symbol, thousand, decimal }?: {
40
- precision?: string | number | undefined;
41
- symbol?: string | undefined;
42
- thousand?: string | undefined;
43
- decimal?: string | undefined;
44
- } | undefined): string;