util-helpers 4.2.0 → 4.4.0

package/esm/normalizeString.js

@@ -0,0 +1,32 @@
+import isNil from './utils/type/isNil';
+import convertToString from './utils/convertToString';
+/**
+ * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+ *
+ * @static
+ * @alias module:Processor.normalizeString
+ * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @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/safeDate.js

@@ -0,0 +1,40 @@
+import _construct from "@babel/runtime/helpers/construct";
+import isNil from './utils/type/isNil'; // TODO: 函数重载，类型参照 Date
+
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+
+function safeDate(value) {
+  var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
+
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+
+  if (args && args.length > 0) {
+    // @ts-ignore
+    return _construct(Date, [safeValue].concat(args));
+  } // @ts-ignore
+
+
+  return isNil(safeValue) ? new Date() : new Date(safeValue);
+}
+
+export default safeDate;

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

@@ -3,7 +3,7 @@
  *
  * @static
  * @alias module:Other.waitTime
- * @since 3.1.0
+ * @since 4.2.0
  * @param {number} [time=1000] 延时时间，单位毫秒
  * @returns {Promise<void>}
  * @example

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,18 @@ Object.defineProperty(exports, "setDataURLPrefix", {
     return _setDataURLPrefix["default"];
   }
 });
+Object.defineProperty(exports, "normalizeString", {
+  enumerable: true,
+  get: function get() {
+    return _normalizeString["default"];
+  }
+});
+Object.defineProperty(exports, "safeDate", {
+  enumerable: true,
+  get: function get() {
+    return _safeDate["default"];
+  }
+});
 Object.defineProperty(exports, "plus", {
   enumerable: true,
   get: function get() {
@@ -286,6 +298,10 @@ var _dataURLToBlob = _interopRequireDefault(require("./dataURLToBlob"));
 
 var _setDataURLPrefix = _interopRequireDefault(require("./setDataURLPrefix"));
 
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
+var _safeDate = _interopRequireDefault(require("./safeDate"));
+
 var _plus = _interopRequireDefault(require("./plus"));
 
 var _minus = _interopRequireDefault(require("./minus"));

package/lib/normalizeString.js

@@ -0,0 +1,43 @@
+"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
+ * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @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/safeDate.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _isNil = _interopRequireDefault(require("./utils/type/isNil"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct; } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
+
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+
+// TODO: 函数重载，类型参照 Date
+
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+function safeDate(value) {
+  var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
+
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+
+  if (args && args.length > 0) {
+    // @ts-ignore
+    return _construct(Date, [safeValue].concat(args));
+  } // @ts-ignore
+
+
+  return (0, _isNil["default"])(safeValue) ? new Date() : new Date(safeValue);
+}
+
+var _default = safeDate;
+exports["default"] = _default;

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

@@ -10,7 +10,7 @@ exports["default"] = void 0;
  *
  * @static
  * @alias module:Other.waitTime
- * @since 3.1.0
+ * @since 4.2.0
  * @param {number} [time=1000] 延时时间，单位毫秒
  * @returns {Promise<void>}
  * @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/index.d.ts

@@ -28,6 +28,8 @@ 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 safeDate } from "./safeDate";
 export { default as plus } from "./plus";
 export { default as minus } from "./minus";
 export { default as times } from "./times";

package/types/normalizeString.d.ts

@@ -0,0 +1,22 @@
+export default normalizeString;
+/**
+ * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+ *
+ * @static
+ * @alias module:Processor.normalizeString
+ * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
+ * @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/safeDate.d.ts

@@ -0,0 +1,21 @@
+export default safeDate;
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+declare function safeDate(value?: string | number | Date | undefined, ...args: number[]): Date;

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

@@ -4,7 +4,7 @@ export default waitTime;
  *
  * @static
  * @alias module:Other.waitTime
- * @since 3.1.0
+ * @since 4.2.0
  * @param {number} [time=1000] 延时时间，单位毫秒
  * @returns {Promise<void>}
  * @example