@ceale/util 1.7.0 → 1.8.0

package/dist/cjs/index.js

@@ -29,7 +29,13 @@ var __export = (target, all) => {
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
+  waitSync: () => waitSync,
+  wait: () => wait,
   uri: () => uri,
+  throttle: () => throttle,
+  sleepAsync: () => sleepAsync,
+  sleep: () => sleep,
+  debounce: () => debounce,
   css: () => css
 });
 module.exports = __toCommonJS(exports_src);
@@ -200,3 +206,46 @@ var css;
 `);
   };
 })(css ||= {});
+// src/time.ts
+var wait = async (time) => {
+  return new Promise((resolve) => setTimeout(resolve, time));
+};
+var sleepAsync = wait;
+var sleep = (time) => {
+  const start = Date.now();
+  while (true)
+    if (Date.now() - start >= time)
+      return;
+};
+var waitSync = sleep;
+// src/task.ts
+var debounce = (func, delay) => {
+  let timer = null;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      func.apply(this, args);
+    }, delay);
+  };
+};
+var throttle = (func, delay) => {
+  let timer = false;
+  let lastArgs = null;
+  return function(...args) {
+    if (timer) {
+      lastArgs = args;
+      return;
+    }
+    func.apply(this, args);
+    timer = true;
+    setTimeout(() => {
+      if (lastArgs) {
+        func.apply(this, lastArgs);
+        lastArgs = null;
+      }
+      timer = false;
+    }, delay);
+  };
+};

package/dist/esm/index.js

@@ -164,7 +164,56 @@ var css;
 `);
   };
 })(css ||= {});
+// src/time.ts
+var wait = async (time) => {
+  return new Promise((resolve) => setTimeout(resolve, time));
+};
+var sleepAsync = wait;
+var sleep = (time) => {
+  const start = Date.now();
+  while (true)
+    if (Date.now() - start >= time)
+      return;
+};
+var waitSync = sleep;
+// src/task.ts
+var debounce = (func, delay) => {
+  let timer = null;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      func.apply(this, args);
+    }, delay);
+  };
+};
+var throttle = (func, delay) => {
+  let timer = false;
+  let lastArgs = null;
+  return function(...args) {
+    if (timer) {
+      lastArgs = args;
+      return;
+    }
+    func.apply(this, args);
+    timer = true;
+    setTimeout(() => {
+      if (lastArgs) {
+        func.apply(this, lastArgs);
+        lastArgs = null;
+      }
+      timer = false;
+    }, delay);
+  };
+};
 export {
+  waitSync,
+  wait,
   uri,
+  throttle,
+  sleepAsync,
+  sleep,
+  debounce,
   css
 };

package/dist/types/index.d.ts

@@ -2,3 +2,5 @@ export * from "./string";
 export * from "./uri";
 export * from "./class";
 export * from "./css";
+export * from "./time";
+export * from "./task";

package/dist/types/task.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 将传入的函数变为防抖版本
+ *
+ * 在间隔低于`delay`连续触发函数时，只会执行最后一次调用，并在最后一次调用后延时`delay`执行
+ * @param func 原始函数
+ * @param delay 防抖时长，毫秒
+ * @returns 带防抖的函数
+ */
+export declare const debounce: <F extends (...args: any[]) => void>(func: F, delay: number) => ((...args: Parameters<F>) => void);
+/**
+ * 将传入的函数变为节流版本
+ *
+ * 函数将在首次调用后执行，首次调用后的`delay`内，如重复调用，
+ *
+ * 则函数将以最后一次调用的参数，在首次调用后延迟`delay`后执行
+ * @param func 原始函数
+ * @param delay 节流时长，毫秒
+ * @returns 带节流的函数
+ */
+export declare const throttle: <F extends (...args: any[]) => void>(func: F, delay: number) => ((...args: Parameters<F>) => void);

package/dist/types/time.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 异步地等待指定时间，基于Promise和setTimeout实现
+ * @param time 时长，单位为毫秒
+ * @returns void
+ * @alias sleepAsync
+ */
+export declare const wait: (time: number) => Promise<void>;
+/**
+ * 异步地等待指定时间，基于Promise和setTimeout实现
+ * @param time 时长，单位为毫秒
+ * @returns void
+ * @alias wait
+ */
+export declare const sleepAsync: (time: number) => Promise<void>;
+/**
+ * 同步地等待指定时间，基于while和Date.now实现
+ *
+ * **请慎用该方法，其可能导致cpu占用过高**
+ * @param time 时长，单位为毫秒
+ * @returns void
+ * @alias waitSync
+ */
+export declare const sleep: (time: number) => void;
+/**
+ * 同步地等待指定时间，基于while和Date.now实现
+ *
+ * **请慎用该方法，其可能导致cpu占用过高**
+ * @param time 时长，单位为毫秒
+ * @returns void
+ * @alias sleep
+ */
+export declare const waitSync: (time: number) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ceale/util",
   "author": "Ceale",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "module": "index.ts",
   "type": "module",
   "main": "dist/esm/index.js",