xshell 1.2.14 → 1.2.16

package/utils.browser.d.ts

@@ -133,3 +133,7 @@ export declare class Timer {
 export declare function lowercase_first_letter(str: string): string;
 /** 大于 n 的最小的 2 的幂次 */
 export declare function ceil2(n: number): number;
+/** 节流，最多只在时间间隔末尾调用一次，首次调用也延后 */
+export declare function throttle(duration: number, func: Function, delay_first?: boolean): (this: any, ...args: any[]) => void;
+/** 防抖，间隔一段时间不再触发时调用 */
+export declare function debounce(duration: number, func: Function): (this: any, ...args: any[]) => void;

package/utils.browser.js

@@ -416,4 +416,49 @@ export function ceil2(n) {
         ;
     return power;
 }
+/** 节流，最多只在时间间隔末尾调用一次，首次调用也延后 */
+export function throttle(duration, func, delay_first = false) {
+    let timeout = 0;
+    let last = 0;
+    let saved_this = null;
+    let saved_args = null;
+    return function throttled(...args) {
+        // 当前时间间隔已预定执行，本次调用仅更新调用参数
+        if (timeout) {
+            saved_this = this;
+            saved_args = args;
+            return;
+        }
+        const now = Date.now();
+        if (last === 0 && delay_first)
+            last = now;
+        const ellapsed = now - last;
+        // 过了时间间隔末尾，直接执行
+        if (ellapsed >= duration) {
+            last = now;
+            func.apply(this, args);
+        }
+        else { // 预定在间隔末尾执行
+            saved_this = this;
+            saved_args = args;
+            timeout = setTimeout(() => {
+                timeout = null;
+                last = Date.now();
+                func.apply(saved_this, saved_args);
+                saved_this = null;
+                saved_args = null;
+            }, duration - ellapsed);
+        }
+    };
+}
+/** 防抖，间隔一段时间不再触发时调用 */
+export function debounce(duration, func) {
+    let timeout = null;
+    return function debounced(...args) {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            func.apply(this, args);
+        }, duration);
+    };
+}
 //# sourceMappingURL=utils.browser.js.map

package/utils.d.ts

@@ -210,3 +210,7 @@ export declare function consume_stream(stream: Readable, ignore_error?: boolean)
 export declare function range_to_numbers(range: string, reverse?: boolean): Generator<number, void, unknown>;
 /** 大于 n 的最小的 2 的幂次 */
 export declare function ceil2(n: number): number;
+/** 节流，最多只在时间间隔末尾调用一次，首次调用也延后 */
+export declare function throttle(duration: number, func: Function, delay_first?: boolean): (this: any, ...args: any[]) => void;
+/** 防抖，间隔一段时间不再触发时调用 */
+export declare function debounce(duration: number, func: Function): (this: any, ...args: any[]) => void;

package/utils.js

@@ -692,4 +692,49 @@ export function ceil2(n) {
         ;
     return power;
 }
+/** 节流，最多只在时间间隔末尾调用一次，首次调用也延后 */
+export function throttle(duration, func, delay_first = false) {
+    let timeout = null;
+    let last = 0;
+    let saved_this = null;
+    let saved_args = null;
+    return function throttled(...args) {
+        // 当前时间间隔已预定执行，本次调用仅更新调用参数
+        if (timeout) {
+            saved_this = this;
+            saved_args = args;
+            return;
+        }
+        const now = Date.now();
+        if (last === 0 && delay_first)
+            last = now;
+        const ellapsed = now - last;
+        // 过了时间间隔末尾，直接执行
+        if (ellapsed >= duration) {
+            last = now;
+            func.apply(this, args);
+        }
+        else { // 预定在间隔末尾执行
+            saved_this = this;
+            saved_args = args;
+            timeout = setTimeout(() => {
+                timeout = null;
+                last = Date.now();
+                func.apply(saved_this, saved_args);
+                saved_this = null;
+                saved_args = null;
+            }, duration - ellapsed);
+        }
+    };
+}
+/** 防抖，间隔一段时间不再触发时调用 */
+export function debounce(duration, func) {
+    let timeout = null;
+    return function debounced(...args) {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            func.apply(this, args);
+        }, duration);
+    };
+}
 //# sourceMappingURL=utils.js.map