util-helpers 4.2.1 → 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/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/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() {
@@ -286,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"));

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/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/package.json

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

package/types/index.d.ts

@@ -28,6 +28,7 @@ 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";

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/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;