util-helpers 4.17.0 → 4.17.2

package/esm/index.js

@@ -20,6 +20,7 @@ export { default as isPromiseLike } from './isPromiseLike.js';
 export { default as isHMCard } from './isHMCard.js';
 export { default as isTWCard } from './isTWCard.js';
 export { default as isSwiftCode } from './isSwiftCode.js';
+export { default as isValidNumber } from './isValidNumber.js';
 export { default as formatMoney } from './formatMoney.js';
 export { default as formatBankCard } from './formatBankCard.js';
 export { default as replaceChar } from './replaceChar.js';

package/esm/isValidNumber.js

@@ -0,0 +1,23 @@
+import isSymbol from './utils/type/isSymbol.js';
+
+function isValidNumber(value, strict) {
+    if (strict === void 0) { strict = false; }
+    var ret;
+    if (strict) {
+        ret = typeof value === 'string' && value !== '' ? Number(value) : value;
+    }
+    else {
+        if (typeof value === 'number') {
+            ret = value;
+        }
+        else if (isSymbol(value)) {
+            ret = Number.NaN;
+        }
+        else {
+            ret = Number(value);
+        }
+    }
+    return typeof ret === 'number' && !Number.isNaN(ret);
+}
+
+export { isValidNumber as default };

package/esm/utils/config.js

@@ -4,6 +4,6 @@ var config = {
 function setDisableWarning(bool) {
     config.disableWarning = !!bool;
 }
-var version = "4.17.0";
+var version = "4.17.2";
 
 export { config, setDisableWarning, version };

package/lib/index.js

@@ -22,6 +22,7 @@ var isPromiseLike = require('./isPromiseLike.js');
 var isHMCard = require('./isHMCard.js');
 var isTWCard = require('./isTWCard.js');
 var isSwiftCode = require('./isSwiftCode.js');
+var isValidNumber = require('./isValidNumber.js');
 var formatMoney = require('./formatMoney.js');
 var formatBankCard = require('./formatBankCard.js');
 var replaceChar = require('./replaceChar.js');
@@ -80,6 +81,7 @@ exports.isPromiseLike = isPromiseLike;
 exports.isHMCard = isHMCard;
 exports.isTWCard = isTWCard;
 exports.isSwiftCode = isSwiftCode;
+exports.isValidNumber = isValidNumber;
 exports.formatMoney = formatMoney;
 exports.formatBankCard = formatBankCard;
 exports.replaceChar = replaceChar;

package/lib/isValidNumber.js

@@ -0,0 +1,25 @@
+'use strict';
+
+var isSymbol = require('./utils/type/isSymbol.js');
+
+function isValidNumber(value, strict) {
+    if (strict === void 0) { strict = false; }
+    var ret;
+    if (strict) {
+        ret = typeof value === 'string' && value !== '' ? Number(value) : value;
+    }
+    else {
+        if (typeof value === 'number') {
+            ret = value;
+        }
+        else if (isSymbol(value)) {
+            ret = Number.NaN;
+        }
+        else {
+            ret = Number(value);
+        }
+    }
+    return typeof ret === 'number' && !Number.isNaN(ret);
+}
+
+module.exports = isValidNumber;

package/lib/utils/config.js

@@ -6,6 +6,6 @@ exports.config = {
 function setDisableWarning(bool) {
     exports.config.disableWarning = !!bool;
 }
-exports.version = "4.17.0";
+exports.version = "4.17.2";
 
 exports.setDisableWarning = setDisableWarning;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -10,7 +10,7 @@
   "scripts": {
     "test": "jest --verbose",
     "test:coverage": "jest --coverage",
-    "test:coverage:local": "cross-env COVERAGE_LOCAL=1 jest --coverage",
+    "test:coverage:local": "cross-env COVERAGE_LOCAL=1 jest --coverage && open ./coverage/lcov-report/index.html",
     "test:math": "jest --verbose test/math",
     "test:type": "jest --verbose test/type",
     "test:validator": "jest --verbose test/validator",
@@ -27,7 +27,8 @@
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
     "commit": "cz",
-    "prepublishOnly": "npm test && npm run build"
+    "prepublishOnly": "npm test && npm run build",
+    "tsc": "tsc --noEmit"
   },
   "repository": {
     "type": "git",

package/types/fileReader.d.ts

@@ -5,32 +5,6 @@ declare const FileReaderMethodMap: {
     readonly text: "readAsText";
 };
 type ReadType = keyof typeof FileReaderMethodMap;
-/**
- * 读取 Blob 或 File 对象，转为 Base64/String/ArrayBuffer<br/><br/>
- *
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
- *
- * @static
- * @alias module:Processor.fileReader
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader | FileReader}
- * @since 4.16.0
- * @param {Blob} blob Blob 或 File 对象
- * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] 读取类型
- * @returns {Promise<string|ArrayBuffer>} 文件内容
- * @example
- * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
- * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
- *
- * fileReader(htmlBlob).then(data=>{
- *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
- * });
- *
- * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
- *
- * fileReader(textBlob, 'text').then(data=>{
- *   console.log(data); // <a id="a"><b id="b">hey!</b></a>
- * });
- */
 declare function fileReader(blob: Blob, type: 'arrayBuffer'): Promise<ArrayBuffer>;
 declare function fileReader(blob: Blob, type?: Exclude<ReadType, 'arrayBuffer'>): Promise<string>;
 export default fileReader;

package/types/index.d.ts

@@ -26,6 +26,7 @@ export { default as isPromiseLike } from './isPromiseLike';
 export { default as isHMCard } from './isHMCard';
 export { default as isTWCard } from './isTWCard';
 export { default as isSwiftCode } from './isSwiftCode';
+export { default as isValidNumber } from './isValidNumber';
 /**
  * 数据处理
  *

package/types/isValidNumber.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 检测值是否为有效数值，支持隐式转换。如果返回 true ，表示可以通过 Number() 转为数字。
+ *
+ * @static
+ * @alias module:Validator.isValidNumber
+ * @since 4.17.2
+ * @param {*} value 待检测的值
+ * @param {boolean} [strict=false] 严格模式，如果为 true ，仅支持字符串和数字类型，不处理其他类型隐式转换，且空字符串返回 false 。
+ * @returns {boolean} 值是否为有效数值
+ * @example
+ *
+ * isValidNumber(null); // true
+ * isValidNumber(true); // true
+ * isValidNumber(''); // true
+ * isValidNumber(1234); // true
+ * isValidNumber('1234'); // true
+ * isValidNumber(' 1234 '); // true
+ * isValidNumber(' 1234 '); // true
+ *
+ * isValidNumber(undefined); // false
+ * isValidNumber('0.10.1'); // false
+ *
+ * // 严格模式
+ * isValidNumber(null, true); // false
+ * isValidNumber(true, true); // false
+ * isValidNumber('', true); // false
+ * isValidNumber(1234, true); // true
+ * isValidNumber('1234', true); // true
+ * isValidNumber(' 1234 ', true); // true
+ * isValidNumber(' 1234 ', true); // true
+ */
+declare function isValidNumber(value: any, strict?: boolean): boolean;
+export default isValidNumber;

package/types/safeDate.d.ts

@@ -1,25 +1,3 @@
-/**
- * 创建一个 Date 实例日期对象，同 <a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date#%E5%8F%82%E6%95%B0">new Date()</a> <br/><br/>
- *
- * 规避了苹果设备浏览器不支持部分格式（例如，YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。<br/>
- * 如果参数为 undefined 正常返回 Date 。
- *
- * @static
- * @alias module:Processor.safeDate
- * @since 4.4.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date | Date}
- * @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(): Date;
 declare function safeDate(value: number | string | Date): Date;
 declare function safeDate(year: number, monthIndex: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): Date;