summaryrefslogtreecommitdiff
path: root/shared/components/src/utils/throttle.ts
blob: b5e36bcc47e02f14e6a0c1fb61e3939ebf69fb46 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/* eslint-disable import/prefer-default-export */
/**
 * @name throttle
 * @description
 * Creates a throttled function that only invokes func at most once per every limit time (ms).
 *
 * *NOTE: this does not capture or recall all functions that were triggered.
 * This will drop function calls that happen during the throttle time*
 * @param limit - time to wait between calls in ms
 * @example
 * Normal event
 * event      | |   |   |
 * time     ----------------
 * callback   | |   |   |
 *
 * Throttled event [300ms]
 * event    |   |   |    |
 * time     ----------------
 * callback |      |      |
 *             [300]  [300]
 */

export function throttle<T extends []>(
    func: (..._: T) => unknown,
    limit: number,
): (..._: T) => void {
    let lastTimeoutId;
    let lastCallTime: number;

    return function throttled(...args) {
        const nextCall = () => {
            func.apply(this, args);
            lastCallTime = Date.now();
        };

        if (!lastCallTime) {
            nextCall();
        } else {
            clearTimeout(lastTimeoutId);
            const timeBetweenCalls = Date.now() - lastCallTime;
            const waitTime = Math.max(0, limit - timeBetweenCalls);
            lastTimeoutId = setTimeout(() => {
                if (timeBetweenCalls >= limit) {
                    nextCall();
                }
            }, waitTime);
        }
    };
}