ph-utils 0.8.3 → 0.8.4

package/lib/date.js

@@ -116,8 +116,6 @@ export function format(date, pattern = "yyyy-mm-dd HH:MM:ss") {
 export function parse(date) {
     if (date == null)
         return new Date();
-    if (date instanceof Date)
-        return date;
     if (typeof date === "string" && !/Z$/i.test(date)) {
         const d = date.match(REGEX_PARSE);
         if (d) {
@@ -127,7 +125,7 @@ export function parse(date) {
     if (typeof date === "number") {
         return new Date(date <= 9999999999 ? date * 1000 : date);
     }
-    return new Date();
+    return new Date(date);
 }
 /**
  * 设置日期的开始或者结束的点

package/lib/index.d.ts

@@ -29,37 +29,55 @@ export declare function isNumeric(str: string, numericParam?: {
  */
 export declare function isBoolean(str: string): boolean;
 /** 生成随机数的选项 */
-interface RandomConfig {
+interface RandomStringOption {
     /** 生成指定长度的随机字符串 */
-    length?: number;
+    length: number;
     /** 是否包含英文字母, 默认为: true */
     hasLetter?: boolean;
     /** 生成纯数字的随机数时, 首位是否允许为 0, 默认为: true */
     firstIsZero?: boolean;
+}
+interface RangeRandomOption {
     /** 配合 max 生成 [min~max] 之间的随机数 */
-    min?: number;
+    min: number;
     /** 配合 min 生成 [min~max] 之间的随机数 */
-    max?: number;
+    max: number;
     /** 生成的随机数，是否包含 max, 默认: false */
     hasEnd?: boolean;
     /** 生成的随机数是否是整数, 默认: true */
     isInteger?: boolean;
 }
 /**
- * 生成随机数
- *  1. 生成指定长度的随机数
- *  2. 生成介于 [min, max] 之间的随机数
- * @param opts 生成随机数的配置
+ * 生成指定长度的随机数
+ *
+ * @param len - 生成的随机数长度
  *
  * @example <caption>1. 生成指定长度的随机字符串</caption>
  * random(1); // 长度为 1 的随机字符串
+ */
+export declare function random(len: number): string;
+/**
+ * 生成介于 [min, max] 之间的随机数
  *
- * @example <caption>2. 生成纯数字且不能为0长度为1的随机字符</caption>
- * random({ length: 1, hasLetter: false, firstIsZero: false })
+ * @param option 配置项
+ * @param option.min 生成介于 [min, max] 之间的随机数
+ * @param option.max 生成介于 [min, max] 之间的随机数
+ * @param option.hasEnd 生成的随机数，是否包含 max, 默认: false
+ * @param option.isInteger 生成的随机数是否是整数, 默认: true
+ */
+export declare function random(option: RangeRandomOption): number;
+/**
+ * 生成指定长度随机数
  *
- * @returns
+ * @param option 配置项
+ * @param option.length 生成的随机数长度
+ * @param option.hasLetter 是否包含英文字母, 默认为: true
+ * @param option.firstIsZero 生成纯数字的随机数时, 首位是否允许为 0, 默认为: true
+ *
+ * @example <caption>2. 生成纯数字且首位不能为0长度为1的随机字符</caption>
+ * random({ length: 1, hasLetter: false, firstIsZero: false })
  */
-export declare function random(opts: number | RandomConfig): string | number;
+export declare function random(option: RandomStringOption): string;
 /**
  * 带有错误名称标记的错误类型
  */

package/lib/index.js

@@ -53,20 +53,6 @@ export function isNumeric(str, numericParam) {
 export function isBoolean(str) {
     return ["true", "false"].indexOf(str) >= 0;
 }
-/**
- * 生成随机数
- *  1. 生成指定长度的随机数
- *  2. 生成介于 [min, max] 之间的随机数
- * @param opts 生成随机数的配置
- *
- * @example <caption>1. 生成指定长度的随机字符串</caption>
- * random(1); // 长度为 1 的随机字符串
- *
- * @example <caption>2. 生成纯数字且不能为0长度为1的随机字符</caption>
- * random({ length: 1, hasLetter: false, firstIsZero: false })
- *
- * @returns
- */
 export function random(opts) {
     if (typeof opts === "object" && opts.min != null && opts.max != null) {
         const randomNum = Math.random();
@@ -79,13 +65,13 @@ export function random(opts) {
         if (typeof opts === "object" && opts.length == null) {
             throw new Error("random_length_cannot_null");
         }
-        const len = typeof opts === "object" ? opts.length : opts;
+        let len = typeof opts === "object" ? opts.length : opts;
         /* 生成指定长度的随机数 */
         let chars = RANDOM_CHARS;
         if (typeof opts === "object" && opts.hasLetter === false) {
             chars = NUMBER_RANDOM_CHARTS;
         }
-        const resRandom = Array.from({ length: len }, () => chars.charAt(random({ min: 0, max: 9, hasEnd: true }))).join("");
+        const resRandom = Array.from({ length: len }, () => chars.charAt(random({ min: 0, max: chars.length - 1, hasEnd: true }))).join("");
         if (typeof opts === "object" &&
             opts.firstIsZero === false &&
             resRandom.indexOf("0") === 0) {

package/lib/storage.d.ts

@@ -11,8 +11,8 @@ interface StorageSetOption {
  * 存储值到 Storage 中
  * @param key 设置的 key
  * @param value 设置的值
- * @param storage session 或 local
- * @param expire 数据有效期, 单位秒, 默认: -1 - 永久存储
+ * @param [option.storage] session 或 local, 默认: session
+ * @param [option.expire] 数据有效期, 单位秒, 默认: -1 - 永久存储
  */
 export declare function set(key: string, value: any, option?: StorageSetOption): void;
 /**
@@ -37,8 +37,8 @@ interface StorageQueryOption {
  * 从 Storage 中取出数据
  * @param key 保存时的 key
  * @param defaultValue 没有数据时的默认值
- * @param delete 是否在取出后，删除数据，默认：false - 取出后删除数据
- * @param storage 使用的 Storage ，可以是 localStorage、sessionStorage
+ * @param [option.delete] 是否在取出后，删除数据，默认：false - 取出后删除数据
+ * @param [option.storage] 使用的 Storage ，可以是 localStorage、sessionStorage, 默认: localStorage、sessionStorage
  * @returns Storage 中 key 对应的数据
  */
 export declare function get<T>(key: string, defaultValue?: T, option?: StorageQueryOption): T;

package/lib/storage.js

@@ -5,8 +5,8 @@ function getStorage(storage = "session") {
  * 存储值到 Storage 中
  * @param key 设置的 key
  * @param value 设置的值
- * @param storage session 或 local
- * @param expire 数据有效期, 单位秒, 默认: -1 - 永久存储
+ * @param [option.storage] session 或 local, 默认: session
+ * @param [option.expire] 数据有效期, 单位秒, 默认: -1 - 永久存储
  */
 export function set(key, value, option) {
     const opts = {
@@ -40,8 +40,8 @@ export function remove(key, storage) {
  * 从 Storage 中取出数据
  * @param key 保存时的 key
  * @param defaultValue 没有数据时的默认值
- * @param delete 是否在取出后，删除数据，默认：false - 取出后删除数据
- * @param storage 使用的 Storage ，可以是 localStorage、sessionStorage
+ * @param [option.delete] 是否在取出后，删除数据，默认：false - 取出后删除数据
+ * @param [option.storage] 使用的 Storage ，可以是 localStorage、sessionStorage, 默认: localStorage、sessionStorage
  * @returns Storage 中 key 对应的数据
  */
 export function get(key, defaultValue, option) {

package/package.json

@@ -60,7 +60,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.8.3",
+  "version": "0.8.4",
   "type": "module",
   "repository": {
     "type": "git",