Debounce a function in JavaScript

debounce.js

/**
 * Either returns a function that won't execute until it hasn't been called for
 * `delay` milliseconds, or returns a function that will execute immediately but
 * not again until it hasn't been called in `delay` milliseconds.
 * @param {function(...any)} func The function to execute only once.
 * @param {number} delay Number of milliseconds to wait after the last call
 * before executing the function.
 * @param {boolean} immediate If true, will execute immediately rather than
 * waiting, but won't execute again until it hasn't been called in `delay` ms.
 * @return {function(...any)} A function that, when called, will execute `func`
 * according to the above behavior.
 */
function debounce(func, delay, immediate = false) {
    let debounceTimeoutId = null;
    return function (...args) {
        if (immediate && debounceTimeoutId === null) {
            func(...args);
        }

        clearTimeout(debounceTimeoutId);
        debounceTimeoutId = setTimeout(() => {
            if (!immediate) {
                func(...args);
            }

            debounceTimeoutId = null;
        }, delay);
    }
}