ph-utils 0.2.7 → 0.2.11

package/lib/date.js

@@ -100,10 +100,10 @@ function startOf(date, unit, isEnd = false) {
 exports.startOf = startOf;
 /**
  * 日期加上指定时间后的日期
- * @param date {Date | number | string | null}  指定的日期
- * @param num {number}  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
- * @param unit {string}  需要添加的单位，date - 加减天数
- * @param fmt {string}   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ * @param date  指定的日期
+ * @param num   需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit  需要添加的单位，date - 加减天数
+ * @param fmt   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
  * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
  */
 function add(date, num, unit, fmt) {

package/lib/file.d.ts

@@ -24,5 +24,11 @@ declare const _default: {
      * @param done 遍历完成后的回调
      */
     traverseDir(dir: string, callback?: (filename: string) => void, done?: () => void): void;
+    /**
+     * 根据文件的 stat 获取文件的 etag
+     * @param filePath 文件地址
+     * @returns file stat etag
+     */
+    statTag(filePath: string): Promise<string>;
 };
 export = _default;

package/lib/file.js

@@ -71,7 +71,9 @@ module.exports = {
                             clearTimeout(t);
                             t = setTimeout(() => {
                                 setImmediate(() => {
-                                    done();
+                                    if (typeof done === 'function') {
+                                        done();
+                                    }
                                 });
                             }, 10);
                         }
@@ -85,4 +87,13 @@ module.exports = {
         }
         list(dir, callback, done);
     },
+    /**
+     * 根据文件的 stat 获取文件的 etag
+     * @param filePath 文件地址
+     * @returns file stat etag
+     */
+    async statTag(filePath) {
+        let stat = await fs.promises.stat(filePath);
+        return `${stat.size.toString(16)}-${stat.mtimeMs.toString(16)}`;
+    },
 };

package/lib/index.d.ts

@@ -50,5 +50,12 @@ export declare class BaseError extends Error {
      * @param name 错误名称
      * @param message 错误描述
      */
-    constructor(name: String, message: string);
+    constructor(name: string, message: string);
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait: number): (...args: any[]) => void;

package/lib/index.js

@@ -3,7 +3,7 @@
  * node 和 web 通用的工具类
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseError = exports.isBoolean = exports.isNumeric = exports.shieldMobile = exports.isBlank = void 0;
+exports.throttle = exports.BaseError = exports.isBoolean = exports.isNumeric = exports.shieldMobile = exports.isBlank = void 0;
 /**
  * 验证字符串是否为空
  * @param str               待验证的字符串
@@ -77,3 +77,20 @@ class BaseError extends Error {
     }
 }
 exports.BaseError = BaseError;
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+function throttle(func, wait) {
+    let lastTime = 0;
+    return function (...args) {
+        let now = Date.now();
+        if (now - lastTime >= wait) {
+            func(...args);
+            lastTime = now;
+        }
+    };
+}
+exports.throttle = throttle;

package/lib/index_m.d.ts

@@ -50,5 +50,12 @@ export declare class BaseError extends Error {
      * @param name 错误名称
      * @param message 错误描述
      */
-    constructor(name: String, message: string);
+    constructor(name: string, message: string);
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait: number): (...args: any[]) => void;

package/lib/index_m.js

@@ -64,3 +64,19 @@ export class BaseError extends Error {
         }
     }
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export function throttle(func, wait) {
+    let lastTime = 0;
+    return function (...args) {
+        let now = Date.now();
+        if (now - lastTime >= wait) {
+            func(...args);
+            lastTime = now;
+        }
+    };
+}

package/lib/server.js

@@ -59,7 +59,7 @@ module.exports = {
             options = { ...(options || {}) };
             const errorName = options.errorName || 'ExecError';
             delete options.errorName;
-            child_process_1.exec(cmd, options, (error, stdout, stderr) => {
+            (0, child_process_1.exec)(cmd, options, (error, stdout, stderr) => {
                 let err = null;
                 let rs = null;
                 if (error) {

package/lib/validator_m.js

@@ -216,4 +216,5 @@ class Validator {
         return rules;
     }
 }
+// @ts-ignore
 export default Validator;

package/package.json

@@ -5,7 +5,7 @@
   "module": "lib/index_m.js",
   "types": "lib/index.d.ts",
   "browser": "lib/index_m.js",
-  "version": "0.2.7",
+  "version": "0.2.11",
   "repository": {
     "type": "git",
     "url": "git+https//gitee.com/towardly/ph.git",
@@ -19,7 +19,7 @@
   "homepage": "https://gitee.com/towardly/ph/tree/master/packages/utils",
   "devDependencies": {
     "@types/node": "^17.0.21",
-    "typescript": "^4.5.5"
+    "typescript": "4.5.5"
   },
   "scripts": {
     "build": "node scripts/build.js"