util-helpers 4.0.6 → 4.2.0

package/lib/index.js

@@ -165,6 +165,24 @@ Object.defineProperty(exports, "parseIdCard", {
     return _parseIdCard["default"];
   }
 });
+Object.defineProperty(exports, "blobToDataURL", {
+  enumerable: true,
+  get: function get() {
+    return _blobToDataURL["default"];
+  }
+});
+Object.defineProperty(exports, "dataURLToBlob", {
+  enumerable: true,
+  get: function get() {
+    return _dataURLToBlob["default"];
+  }
+});
+Object.defineProperty(exports, "setDataURLPrefix", {
+  enumerable: true,
+  get: function get() {
+    return _setDataURLPrefix["default"];
+  }
+});
 Object.defineProperty(exports, "plus", {
   enumerable: true,
   get: function get() {
@@ -195,6 +213,12 @@ Object.defineProperty(exports, "round", {
     return _round["default"];
   }
 });
+Object.defineProperty(exports, "waitTime", {
+  enumerable: true,
+  get: function get() {
+    return _waitTime["default"];
+  }
+});
 Object.defineProperty(exports, "setDisableWarning", {
   enumerable: true,
   get: function get() {
@@ -256,6 +280,12 @@ var _bytesToSize = _interopRequireDefault(require("./bytesToSize"));
 
 var _parseIdCard = _interopRequireDefault(require("./parseIdCard"));
 
+var _blobToDataURL = _interopRequireDefault(require("./blobToDataURL"));
+
+var _dataURLToBlob = _interopRequireDefault(require("./dataURLToBlob"));
+
+var _setDataURLPrefix = _interopRequireDefault(require("./setDataURLPrefix"));
+
 var _plus = _interopRequireDefault(require("./plus"));
 
 var _minus = _interopRequireDefault(require("./minus"));
@@ -266,6 +296,8 @@ var _divide = _interopRequireDefault(require("./divide"));
 
 var _round = _interopRequireDefault(require("./round"));
 
+var _waitTime = _interopRequireDefault(require("./waitTime"));
+
 var _config = require("./utils/config");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }

package/lib/isBusinessLicense.js

@@ -85,9 +85,9 @@ function isBusinessLicense(value) {
   } // 前14位
 
 
-  var preCode = valueStr.substr(0, 14); // 校验码
+  var preCode = valueStr.substring(0, 14); // 校验码
 
-  var lastCode = valueStr.substr(-1); // 计算校验码
+  var lastCode = valueStr.substring(valueStr.length - 1); // 计算校验码
 
   var checkCode = sumCheckCode(preCode);
   return lastCode === String(checkCode);

package/lib/isSocialCreditCode.js

@@ -104,9 +104,9 @@ function isSocialCreditCode(value) {
   } // 前17位
 
 
-  var preCode = valueStr.substr(0, 17); // 校验码
+  var preCode = valueStr.substring(0, 17); // 校验码
 
-  var lastCode = valueStr.substr(-1); // 计算校验码
+  var lastCode = valueStr.substring(valueStr.length - 1); // 计算校验码
 
   var checkCode = sumCheckCode(preCode);
   return lastCode === checkCode;

package/lib/minus.js

@@ -9,17 +9,29 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
+var _type = require("./utils/type");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 /**
  * 精确减法，支持多个数相减
  *
  * @static
  * @alias module:Math.minus
  * @since 3.1.0
- * @param {number|string} num1 相减的第一个数
- * @param {number|string} num2 相减的第二个数
- * @param {...number|string} others 相减的第其余数
+ * @param {...number|string} nums 相减的数
  * @returns {number} 差
  * @example
  *
@@ -32,14 +44,23 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * minus(1, 0.9, 0.02, 0.08);
  * // => 0
  */
-function minus(num1, num2) {
-  for (var _len = arguments.length, others = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
-    others[_key - 2] = arguments[_key];
+function minus() {
+  for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+    nums[_key] = arguments[_key];
   }
 
-  if (others.length > 0) {
+  var num1 = nums[0],
+      num2 = nums[1],
+      rest = nums.slice(2);
+
+  if (rest.length > 0) {
+    return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
+  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+
+
+  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
     // @ts-ignore
-    return minus.apply(void 0, [minus(num1, num2)].concat(others));
+    return num1;
   }
 
   var baseNum = Math.pow(10, Math.max((0, _math.digitLength)(num1), (0, _math.digitLength)(num2)));

package/lib/parseIdCard.js

@@ -135,7 +135,7 @@ function parseIdCard(id) {
   }
 
   var birthday = "".concat(origin.year, "-").concat(origin.month, "-").concat(origin.day);
-  var gender = Number(origin.gender) % 2 === 0 ? '女' : '男'; // const region = Regions.find(item => item[0] === origin.province?.substr(0, 1));
+  var gender = Number(origin.gender) % 2 === 0 ? '女' : '男'; // const region = Regions.find(item => item[0] === origin.province?.substring(0, 1));
 
   return {
     // region,

package/lib/plus.js

@@ -9,17 +9,29 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
+var _type = require("./utils/type");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 /**
  * 精确加法，支持多个数相加
  *
  * @static
  * @alias module:Math.plus
  * @since 3.1.0
- * @param {number|string} num1 相加的第一个数
- * @param {number|string} num2 相加的第二个数
- * @param {...number|string} others 相加的其余数
+ * @param {...number|string} nums 相加的数
  * @returns {number} 总和
  * @example
  *
@@ -32,14 +44,23 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * plus(0.1, 0.2, 0.3, 0.4);
  * // => 1
  */
-function plus(num1, num2) {
-  for (var _len = arguments.length, others = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
-    others[_key - 2] = arguments[_key];
+function plus() {
+  for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+    nums[_key] = arguments[_key];
   }
 
-  if (others.length > 0) {
+  var num1 = nums[0],
+      num2 = nums[1],
+      rest = nums.slice(2);
+
+  if (rest.length > 0) {
+    return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
+  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+
+
+  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
     // @ts-ignore
-    return plus.apply(void 0, [plus(num1, num2)].concat(others));
+    return num1;
   }
 
   var baseNum = Math.pow(10, Math.max((0, _math.digitLength)(num1), (0, _math.digitLength)(num2)));

package/lib/replaceChar.js

@@ -87,7 +87,7 @@ function replaceChar() {
     middleStr = _char.repeat(repeat);
   }
 
-  return str.substr(0, start) + middleStr + str.substr(end);
+  return str.substring(0, start) + middleStr + str.substring(end);
 }
 
 var _default = replaceChar;

package/lib/setDataURLPrefix.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+/**
+ * 设置 DataURL 前缀、MIME 类型、base64 标识。<br/><br/>
+ *
+ * 如果你需要获取DataURL 的 MIME 类型和数据本身，推荐使用 <a href="https://www.npmjs.com/package/data-urls">data-urls</a>。
+ *
+ * @static
+ * @alias module:Processor.setDataURLPrefix
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
+ * @see 参考 {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
+ * @since 4.1.0
+ * @param {string} data 数据本身
+ * @param {string} [mimetype="image/png"] MIME 类型
+ * @param {boolean} [base64=true] 添加 base64 标识
+ * @returns {string} DataURL 格式的字符串
+ * @example
+ * const data = 'PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
+ * setDataURLPrefix(data); // data:image/png;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'image/png', false); // data:image/png,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'image/jpg'); // data:image/jpg;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'text/html'); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, ''); // data:;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, '', false); // data:,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ */
+function setDataURLPrefix(data) {
+  var mimetype = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'image/png';
+  var base64 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  return "data:".concat(mimetype).concat(base64 ? ';base64' : '', ",").concat(data);
+}
+
+var _default = setDataURLPrefix;
+exports["default"] = _default;

package/lib/times.js

@@ -7,15 +7,27 @@ exports["default"] = void 0;
 
 var _math = require("./utils/math.util");
 
+var _type = require("./utils/type");
+
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 /**
  * 精确乘法，支持多个数相乘
  *
  * @static
  * @alias module:Math.times
  * @since 3.1.0
- * @param {number|string} num1 相乘的第一个数
- * @param {number|string} num2 相乘的第二个数
- * @param {...number|string} others 相乘的其余数
+ * @param {...number|string} nums 相乘的数
  * @returns {number} 乘积
  * @example
  *
@@ -28,14 +40,23 @@ var _math = require("./utils/math.util");
  * times(3, 0.6, 2, 10);
  * // => 36
  */
-function times(num1, num2) {
-  for (var _len = arguments.length, others = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
-    others[_key - 2] = arguments[_key];
+function times() {
+  for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+    nums[_key] = arguments[_key];
   }
 
-  if (others.length > 0) {
+  var num1 = nums[0],
+      num2 = nums[1],
+      rest = nums.slice(2);
+
+  if (rest.length > 0) {
+    return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
+  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+
+
+  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
     // @ts-ignore
-    return times.apply(void 0, [times(num1, num2)].concat(others));
+    return num1;
   }
 
   var num1Changed = (0, _math.float2Fixed)(num1);

package/lib/utils/convertToString.js

@@ -7,26 +7,16 @@ exports["default"] = void 0;
 
 var _isString = _interopRequireDefault(require("./type/isString"));
 
-var _config = require("./config");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /**
  * 转换为字符串
  *
  * @param {*} value 值
- * @returns 字符串
+ * @returns {string} 字符串
  */
 function convertToString(value) {
-  if (!(0, _isString["default"])(value)) {
-    if (!_config.config.disableWarning) {
-      console.warn("[validatePassword] value must be a string.");
-    }
-
-    return String(value);
-  }
-
-  return value;
+  return (0, _isString["default"])(value) ? value : String(value);
 }
 
 var _default = convertToString;

package/lib/utils/math.util.js

@@ -8,6 +8,7 @@ exports.strip = strip;
 exports.digitLength = digitLength;
 exports.float2Fixed = float2Fixed;
 exports.checkBoundary = checkBoundary;
+exports.trimLeftZero = trimLeftZero;
 exports.scientificToNumber = scientificToNumber;
 
 var _constants = require("./constants");
@@ -99,13 +100,13 @@ function checkBoundary(num) {
 
 
 function trimLeftZero(num) {
-  var reg = /^([+-])?(0+)([1-9\.]+)$/;
+  var reg = /^([+-])?(0+)([0-9\.]+)$/;
   var result = reg.exec(num);
   var sign;
 
   if (result) {
     sign = result[1] || '';
-    return sign + result[3];
+    return sign + (result[3][0] === '.' ? '0' + result[3] : result[3]);
   }
 
   return num;
@@ -144,7 +145,7 @@ function scientificToNumber(num) {
       var dec = coeff_array[1]; //如果是整数，将整数除第一位之外的非零数字计入位数，相应的减少0的个数
 
       if (l - dec.length < 0) {
-        num = trimLeftZero(coeff_array[0] + dec.substr(0, l)) + '.' + dec.substr(l);
+        num = trimLeftZero(coeff_array[0] + dec.substring(0, l)) + '.' + dec.substring(l);
       } else {
         //拼接字符串，如果是整数，不需要拼接小数点
         num = coeff_array.join('') + new Array(l - dec.length + 1).join(zero);

package/lib/waitTime.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+/**
+ * 等待时间返回 Promise 。常用于异步方法中延时。
+ *
+ * @static
+ * @alias module:Other.waitTime
+ * @since 3.1.0
+ * @param {number} [time=1000] 延时时间，单位毫秒
+ * @returns {Promise<void>}
+ * @example
+ * const test = async ()=>{
+ *   await waitTime();
+ *   // do something
+ * }
+ *
+ * waitTime(500).then(()=>{
+ *   // do something
+ * })
+ */
+function waitTime() {
+  var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
+  return new Promise(function (resolve) {
+    setTimeout(resolve, time);
+  });
+}
+
+var _default = waitTime;
+exports["default"] = _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.0.6",
+  "version": "4.2.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -25,7 +25,7 @@
     "lint": "eslint src --ext .js",
     "lint:fix": "eslint src --ext .js --fix",
     "commit": "cz",
-    "pub": "npm run build && npm publish",
+    "prepublishOnly": "npm test && npm run build",
     "types": "tsc"
   },
   "repository": {

package/types/blobToDataURL.d.ts

@@ -0,0 +1,25 @@
+export default blobToDataURL;
+/**
+ * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串。
+ *
+ * @static
+ * @alias module:Processor.blobToDataURL
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
+ * @since 4.1.0
+ * @param {Blob} blob Blob 或 File 对象
+ * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
+ * @example
+ * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
+ * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
+ *
+ * blobToDataURL(htmlBlob).then(data=>{
+ *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * });
+ *
+ * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
+ *
+ * blobToDataURL(textBlob).then(data=>{
+ *   console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * });
+ */
+declare function blobToDataURL(blob: Blob): Promise<string>;

package/types/dataURLToBlob.d.ts

@@ -0,0 +1,15 @@
+export default dataURLToBlob;
+/**
+ * 将 DataURL 转为 Blob 对象
+ *
+ * @static
+ * @alias module:Processor.dataURLToBlob
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
+ * @since 4.1.0
+ * @param {string} dataurl data: 协议的URL
+ * @returns {Blob} Blob 对象
+ * @example
+ * const dataurl = 'data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
+ * dataURLToBlob(dataurl);
+ */
+declare function dataURLToBlob(dataurl: string): Blob;

package/types/divide.d.ts

@@ -5,9 +5,7 @@ export default divide;
  * @static
  * @alias module:Math.divide
  * @since 3.1.0
- * @param {number|string} num1 除数
- * @param {number|string} num2 被除数
- * @param {...number|string} others 其余被除数
+ * @param {...number|string} nums 除数和被除数
  * @returns {number} 商数
  * @example
  *
@@ -20,4 +18,4 @@ export default divide;
  * divide(1000, 10, 10, 10);
  * // => 1
  */
-declare function divide(num1: number | string, num2: number | string, ...others: (number | string)[]): number;
+declare function divide(...nums: (number | string)[]): number;

package/types/index.d.ts

@@ -25,9 +25,13 @@ export { default as replaceChar } from "./replaceChar";
 export { default as numberToChinese } from "./numberToChinese";
 export { default as bytesToSize } from "./bytesToSize";
 export { default as parseIdCard } from "./parseIdCard";
+export { default as blobToDataURL } from "./blobToDataURL";
+export { default as dataURLToBlob } from "./dataURLToBlob";
+export { default as setDataURLPrefix } from "./setDataURLPrefix";
 export { default as plus } from "./plus";
 export { default as minus } from "./minus";
 export { default as times } from "./times";
 export { default as divide } from "./divide";
 export { default as round } from "./round";
+export { default as waitTime } from "./waitTime";
 export { setDisableWarning } from "./utils/config";

package/types/minus.d.ts

@@ -5,9 +5,7 @@ export default minus;
  * @static
  * @alias module:Math.minus
  * @since 3.1.0
- * @param {number|string} num1 相减的第一个数
- * @param {number|string} num2 相减的第二个数
- * @param {...number|string} others 相减的第其余数
+ * @param {...number|string} nums 相减的数
  * @returns {number} 差
  * @example
  *
@@ -20,4 +18,4 @@ export default minus;
  * minus(1, 0.9, 0.02, 0.08);
  * // => 0
  */
-declare function minus(num1: number | string, num2: number | string, ...others: (number | string)[]): number;
+declare function minus(...nums: (number | string)[]): number;

package/types/plus.d.ts

@@ -5,9 +5,7 @@ export default plus;
  * @static
  * @alias module:Math.plus
  * @since 3.1.0
- * @param {number|string} num1 相加的第一个数
- * @param {number|string} num2 相加的第二个数
- * @param {...number|string} others 相加的其余数
+ * @param {...number|string} nums 相加的数
  * @returns {number} 总和
  * @example
  *
@@ -20,4 +18,4 @@ export default plus;
  * plus(0.1, 0.2, 0.3, 0.4);
  * // => 1
  */
-declare function plus(num1: number | string, num2: number | string, ...others: (number | string)[]): number;
+declare function plus(...nums: (number | string)[]): number;

package/types/setDataURLPrefix.d.ts

@@ -0,0 +1,25 @@
+export default setDataURLPrefix;
+/**
+ * 设置 DataURL 前缀、MIME 类型、base64 标识。<br/><br/>
+ *
+ * 如果你需要获取DataURL 的 MIME 类型和数据本身，推荐使用 <a href="https://www.npmjs.com/package/data-urls">data-urls</a>。
+ *
+ * @static
+ * @alias module:Processor.setDataURLPrefix
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
+ * @see 参考 {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
+ * @since 4.1.0
+ * @param {string} data 数据本身
+ * @param {string} [mimetype="image/png"] MIME 类型
+ * @param {boolean} [base64=true] 添加 base64 标识
+ * @returns {string} DataURL 格式的字符串
+ * @example
+ * const data = 'PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
+ * setDataURLPrefix(data); // data:image/png;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'image/png', false); // data:image/png,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'image/jpg'); // data:image/jpg;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, 'text/html'); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, ''); // data:;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * setDataURLPrefix(data, '', false); // data:,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ */
+declare function setDataURLPrefix(data: string, mimetype?: string | undefined, base64?: boolean | undefined): string;

package/types/times.d.ts

@@ -5,9 +5,7 @@ export default times;
  * @static
  * @alias module:Math.times
  * @since 3.1.0
- * @param {number|string} num1 相乘的第一个数
- * @param {number|string} num2 相乘的第二个数
- * @param {...number|string} others 相乘的其余数
+ * @param {...number|string} nums 相乘的数
  * @returns {number} 乘积
  * @example
  *
@@ -20,4 +18,4 @@ export default times;
  * times(3, 0.6, 2, 10);
  * // => 36
  */
-declare function times(num1: number | string, num2: number | string, ...others: (number | string)[]): number;
+declare function times(...nums: (number | string)[]): number;

package/types/utils/convertToString.d.ts

@@ -3,6 +3,6 @@ export default convertToString;
  * 转换为字符串
  *
  * @param {*} value 值
- * @returns 字符串
+ * @returns {string} 字符串
  */
-declare function convertToString(value: any): any;
+declare function convertToString(value: any): string;

package/types/utils/math.util.d.ts

@@ -36,6 +36,13 @@ export function float2Fixed(num: number | string): number;
  * @returns
  */
 export function checkBoundary(num: number): void;
+/**
+ * 去掉左边数字0
+ *
+ * @param {string} num 数字字符串
+ * @returns {string}
+ */
+export function trimLeftZero(num: string): string;
 /**
  * 科学计数法转换成普通数字
  *

package/types/waitTime.d.ts

@@ -0,0 +1,20 @@
+export default waitTime;
+/**
+ * 等待时间返回 Promise 。常用于异步方法中延时。
+ *
+ * @static
+ * @alias module:Other.waitTime
+ * @since 3.1.0
+ * @param {number} [time=1000] 延时时间，单位毫秒
+ * @returns {Promise<void>}
+ * @example
+ * const test = async ()=>{
+ *   await waitTime();
+ *   // do something
+ * }
+ *
+ * waitTime(500).then(()=>{
+ *   // do something
+ * })
+ */
+declare function waitTime(time?: number | undefined): Promise<void>;