util-helpers 4.1.0 → 4.3.0

package/esm/normalizeString.js

@@ -0,0 +1,31 @@
+import isNil from './utils/type/isNil';
+import convertToString from './utils/convertToString';
+/**
+ * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+ *
+ * @static
+ * @alias module:Processor.normalizeString
+ * @since 4.3.0
+ * @param {*} value 待处理的值
+ * @returns {string} 规整化的值
+ * @example
+ * normalizeString(); // ''
+ * normalizeString(undefined); // ''
+ * normalizeString(void 0); // ''
+ * normalizeString(null); // ''
+ *
+ * normalizeString(true); // 'true'
+ * normalizeString(NaN); // 'NaN'
+ * normalizeString(1); // '1'
+ * normalizeString('a'); // 'a'
+ */
+
+function normalizeString(value) {
+  if (isNil(value)) {
+    return '';
+  }
+
+  return convertToString(value);
+}
+
+export default normalizeString;

package/esm/setDataURLPrefix.js

@@ -6,6 +6,8 @@
  * @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 标识

package/esm/utils/type/isNil.js

@@ -0,0 +1,17 @@
+import isUndefined from './isUndefined';
+import isNull from './isNull';
+/**
+ * 检查值是否为 undefined 或 null
+ *
+ * @static
+ * @alias module:Type.isNaN
+ * @since 4.3.0
+ * @param {*} value 检查值
+ * @returns {boolean} 是否为 undefined 或 null
+ */
+
+function isNil(value) {
+  return isUndefined(value) || isNull(value);
+}
+
+export default isNil;

package/esm/waitTime.js

@@ -0,0 +1,26 @@
+/**
+ * 等待时间返回 Promise 。常用于异步方法中延时。
+ *
+ * @static
+ * @alias module:Other.waitTime
+ * @since 4.2.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);
+  });
+}
+
+export default waitTime;

package/lib/formatBankCard.js

@@ -5,6 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
 /**
  * 格式化银行卡号
  *
@@ -46,7 +50,7 @@ function formatBankCard() {
 
   var reg = new RegExp("(.{".concat(length, "})"), 'g');
   var regChar = new RegExp("".concat(_char), 'g');
-  var realValue = bankCardNo.replace(regChar, '');
+  var realValue = (0, _normalizeString["default"])(bankCardNo).replace(regChar, '');
   var needRemoveLastChar = realValue.length % length === 0;
   var str = realValue.replace(reg, "$1".concat(_char));
   return needRemoveLastChar ? str.substring(0, str.length - 1) : str;

package/lib/index.js

@@ -183,6 +183,12 @@ Object.defineProperty(exports, "setDataURLPrefix", {
     return _setDataURLPrefix["default"];
   }
 });
+Object.defineProperty(exports, "normalizeString", {
+  enumerable: true,
+  get: function get() {
+    return _normalizeString["default"];
+  }
+});
 Object.defineProperty(exports, "plus", {
   enumerable: true,
   get: function get() {
@@ -213,6 +219,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() {
@@ -280,6 +292,8 @@ var _dataURLToBlob = _interopRequireDefault(require("./dataURLToBlob"));
 
 var _setDataURLPrefix = _interopRequireDefault(require("./setDataURLPrefix"));
 
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
 var _plus = _interopRequireDefault(require("./plus"));
 
 var _minus = _interopRequireDefault(require("./minus"));
@@ -290,6 +304,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/normalizeString.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _isNil = _interopRequireDefault(require("./utils/type/isNil"));
+
+var _convertToString = _interopRequireDefault(require("./utils/convertToString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+/**
+ * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+ *
+ * @static
+ * @alias module:Processor.normalizeString
+ * @since 4.3.0
+ * @param {*} value 待处理的值
+ * @returns {string} 规整化的值
+ * @example
+ * normalizeString(); // ''
+ * normalizeString(undefined); // ''
+ * normalizeString(void 0); // ''
+ * normalizeString(null); // ''
+ *
+ * normalizeString(true); // 'true'
+ * normalizeString(NaN); // 'NaN'
+ * normalizeString(1); // '1'
+ * normalizeString('a'); // 'a'
+ */
+function normalizeString(value) {
+  if ((0, _isNil["default"])(value)) {
+    return '';
+  }
+
+  return (0, _convertToString["default"])(value);
+}
+
+var _default = normalizeString;
+exports["default"] = _default;

package/lib/setDataURLPrefix.js

@@ -13,6 +13,8 @@ exports["default"] = void 0;
  * @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 标识

package/lib/utils/type/isNil.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _isUndefined = _interopRequireDefault(require("./isUndefined"));
+
+var _isNull = _interopRequireDefault(require("./isNull"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+/**
+ * 检查值是否为 undefined 或 null
+ *
+ * @static
+ * @alias module:Type.isNaN
+ * @since 4.3.0
+ * @param {*} value 检查值
+ * @returns {boolean} 是否为 undefined 或 null
+ */
+function isNil(value) {
+  return (0, _isUndefined["default"])(value) || (0, _isNull["default"])(value);
+}
+
+var _default = isNil;
+exports["default"] = _default;

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 4.2.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.1.0",
+  "version": "4.3.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/index.d.ts

@@ -28,9 +28,11 @@ 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 normalizeString } from "./normalizeString";
 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/normalizeString.d.ts

@@ -0,0 +1,21 @@
+export default normalizeString;
+/**
+ * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+ *
+ * @static
+ * @alias module:Processor.normalizeString
+ * @since 4.3.0
+ * @param {*} value 待处理的值
+ * @returns {string} 规整化的值
+ * @example
+ * normalizeString(); // ''
+ * normalizeString(undefined); // ''
+ * normalizeString(void 0); // ''
+ * normalizeString(null); // ''
+ *
+ * normalizeString(true); // 'true'
+ * normalizeString(NaN); // 'NaN'
+ * normalizeString(1); // '1'
+ * normalizeString('a'); // 'a'
+ */
+declare function normalizeString(value: any): string;

package/types/setDataURLPrefix.d.ts

@@ -7,6 +7,8 @@ export default setDataURLPrefix;
  * @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 标识

package/types/utils/type/isNil.d.ts

@@ -0,0 +1,11 @@
+export default isNil;
+/**
+ * 检查值是否为 undefined 或 null
+ *
+ * @static
+ * @alias module:Type.isNaN
+ * @since 4.3.0
+ * @param {*} value 检查值
+ * @returns {boolean} 是否为 undefined 或 null
+ */
+declare function isNil(value: any): boolean;

package/types/waitTime.d.ts

@@ -0,0 +1,20 @@
+export default waitTime;
+/**
+ * 等待时间返回 Promise 。常用于异步方法中延时。
+ *
+ * @static
+ * @alias module:Other.waitTime
+ * @since 4.2.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>;