TypeScript实用的Delay延迟执行工具类

作者：代码拾荒时间：2026-11-01 03:41:04浏览：520

本文介绍了一个TypeScript实用的Delay延迟执行工具类，包含sleep基础延迟、execute异步函数延迟、debounce防抖以及throttle节流四个核心方法。通过实际代码示例，详细解析了各方法的实现原理与适用场景，帮助开发者优化前端性能并提升用户体验。

前端开发常涉及延迟执行、防抖及节流场景。本文介绍一个实用的Delay工具类，涵盖上述常用延迟执行功能。

0、完整代码

/**
 * 延迟执行工具类
 */
export class Delay {
    /**
     * 延迟指定时间
     * @param ms 延迟的毫秒数
     * @returns Promise对象
     */
    static sleep(ms: number): Promise<void> {
        return new Promise(resolve => setTimeout(resolve, ms));
    }

    /**
     * 延迟执行函数
     * @param fn 要执行的函数
     * @param ms 延迟的毫秒数
     * @returns Promise对象，包含函数执行结果
     */
    static async execute<T>(fn: () => T | Promise<T>, ms: number): Promise<T> {
        await this.sleep(ms);
        return await fn();
    }

    /**
     * 创建防抖函数
     * @param fn 要执行的函数
     * @param ms 延迟时间
     * @returns 防抖后的函数
     */
    static debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
        let timeoutId: NodeJS.Timeout;
        
        return function (...args: Parameters<T>) {
            clearTimeout(timeoutId);
            timeoutId = setTimeout(() => fn.apply(this, args), ms);
        };
    }

    /**
     * 创建节流函数
     * @param fn 要执行的函数
     * @param ms 间隔时间
     * @returns 节流后的函数
     */
    static throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
        let isThrottled = false;
        
        return function (...args: Parameters<T>) {
            if (!isThrottled) {
                fn.apply(this, args);
                isThrottled = true;
                setTimeout(() => isThrottled = false, ms);
            }
        };
    }
}

1. 基础延迟执行

sleep方法

sleep方法提供简单的延迟执行功能：

// 延迟2秒
await Delay.sleep(2000);
console.log('2秒后执行');

// 在async函数中使用
async function demo() {
    console.log('开始');
    await Delay.sleep(1000);
    console.log('1秒后');
}

execute方法

execute方法用于延迟执行函数：

// 延迟3秒执行函数
const result = await Delay.execute(() => {
    return '延迟执行的结果';
}, 3000);

// 异步函数示例
await Delay.execute(async () => {
    const response = await fetch('https://api.example.com/data');
    return response.json();
}, 1000);

2. 防抖(Debounce)

防抖指短时间内多次触发同一函数时，仅执行最后一次。典型场景包括：

搜索框输入
窗口调整
按钮点击

实现原理

每次触发时清除前一个定时器并重置新定时器，确保指定时间内无新触发才执行。

使用示例

// 创建防抖函数
const debouncedSearch = Delay.debounce((searchTerm: string) => {
    console.log('搜索:', searchTerm);
}, 500);

// 在输入框onChange事件中使用
<input onChange={(e) => debouncedSearch(e.target.value)} />

// 窗口调整示例
const debouncedResize = Delay.debounce(() => {
    console.log('窗口大小改变');
}, 200);

window.addEventListener('resize', debouncedResize);

3. 节流(Throttle)

节流指在固定时间间隔内仅执行一次函数，无论调用次数。典型场景包括：

滚动事件处理
频繁点击
游戏中的射击

实现原理

通过标志位控制执行：指定时间内标志位为true时阻止执行，时间到后设为false以允许下次执行。

使用示例

// 创建节流函数
const throttledScroll = Delay.throttle(() => {
    console.log('页面滚动');
}, 200);

// 在滚动事件中使用
window.addEventListener('scroll', throttledScroll);

// 游戏射击示例
const throttledShoot = Delay.throttle(() => {
    console.log('发射子弹');
}, 1000);

button.addEventListener('click', throttledShoot);