快捷導(dǎo)航

TypeScript實(shí)用的Delay延遲執(zhí)行工具類

更新時(shí)間：2024年11月04日 11:46:45 作者：訾博ZiBo

在前端開發(fā)中,我們經(jīng)常需要處理一些延遲執(zhí)行、防抖和節(jié)流的場景,今天介紹一個(gè)實(shí)用的Delay工具類,它提供了這些常用的延遲執(zhí)行功能,下面我們就看看它的具體應(yīng)用吧

0、完整代碼

/**
 * 延遲執(zhí)行工具類
 */
export class Delay {
    /**
     * 延遲指定時(shí)間
     * @param ms 延遲的毫秒數(shù)
     * @returns Promise對象
     */
    static sleep(ms: number): Promise<void> {
        return new Promise(resolve => setTimeout(resolve, ms));
    }

    /**
     * 延遲執(zhí)行函數(shù)
     * @param fn 要執(zhí)行的函數(shù)
     * @param ms 延遲的毫秒數(shù)
     * @returns Promise對象，包含函數(shù)執(zhí)行結(jié)果
     */
    static async execute<T>(fn: () => T | Promise<T>, ms: number): Promise<T> {
        await this.sleep(ms);
        return await fn();
    }

    /**
     * 創(chuàng)建防抖函數(shù)
     * @param fn 要執(zhí)行的函數(shù)
     * @param ms 延遲時(shí)間
     * @returns 防抖后的函數(shù)
     */
    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);
        };
    }

    /**
     * 創(chuàng)建節(jié)流函數(shù)
     * @param fn 要執(zhí)行的函數(shù)
     * @param ms 間隔時(shí)間
     * @returns 節(jié)流后的函數(shù)
     */
    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. 基礎(chǔ)延遲執(zhí)行

sleep方法

sleep方法提供了一個(gè)簡單的延遲執(zhí)行功能：

// 延遲2秒
await Delay.sleep(2000);
console.log('2秒后執(zhí)行');

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

execute方法

execute方法可以延遲執(zhí)行一個(gè)函數(shù)：

// 延遲3秒執(zhí)行函數(shù)
const result = await Delay.execute(() => {
    return '延遲執(zhí)行的結(jié)果';
}, 3000);

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

2. 防抖(Debounce)

防抖是指在短時(shí)間內(nèi)多次觸發(fā)同一個(gè)函數(shù)，只執(zhí)行最后一次。典型場景包括：

搜索框輸入
窗口調(diào)整
按鈕點(diǎn)擊

實(shí)現(xiàn)原理

每次觸發(fā)時(shí)都會(huì)清除之前的定時(shí)器，重新設(shè)置一個(gè)新的定時(shí)器，確保只有在指定時(shí)間內(nèi)沒有新的觸發(fā)時(shí)才執(zhí)行函數(shù)。

使用示例

// 創(chuàng)建防抖函數(shù)
const debouncedSearch = Delay.debounce((searchTerm: string) => {
    console.log('搜索:', searchTerm);
}, 500);

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

// 窗口調(diào)整示例
const debouncedResize = Delay.debounce(() => {
    console.log('窗口大小改變');
}, 200);

window.addEventListener('resize', debouncedResize);

3. 節(jié)流(Throttle)

節(jié)流是指在一定時(shí)間間隔內(nèi)只執(zhí)行一次函數(shù)，無論這個(gè)函數(shù)被調(diào)用多少次。典型場景包括：

滾動(dòng)事件處理
頻繁點(diǎn)擊
游戲中的射擊

實(shí)現(xiàn)原理

通過一個(gè)標(biāo)志位控制函數(shù)執(zhí)行，在指定時(shí)間間隔內(nèi)，該標(biāo)志位為true時(shí)阻止函數(shù)執(zhí)行，時(shí)間到后將標(biāo)志位設(shè)為false允許下次執(zhí)行。

使用示例

// 創(chuàng)建節(jié)流函數(shù)
const throttledScroll = Delay.throttle(() => {
    console.log('頁面滾動(dòng)');
}, 200);

// 在滾動(dòng)事件中使用
window.addEventListener('scroll', throttledScroll);

// 游戲射擊示例
const throttledShoot = Delay.throttle(() => {
    console.log('發(fā)射子彈');
}, 1000);

button.addEventListener('click', throttledShoot);