/**
 * 經(jīng)典防抖：最后一次觸發(fā)后等待delay毫秒執(zhí)行
 * @param {Function} fn - 目標(biāo)函數(shù)
 * @param {number} delay - 延遲時間(ms)
 * @returns {Function} - 防抖處理后的函數(shù)
*/
function debounce(fn, delay) {
  // 用于保存定時器ID的閉包變量
  let timer;

  // 返回一個包裝后的新函數(shù)
  return function(...args) {
    // 如果已存在定時器，先清除之前的（避免多次觸發(fā)）
    if (timer) clearTimeout(timer);

    // 設(shè)置新的定時器，在延遲時間后執(zhí)行原函數(shù)
    timer = setTimeout(() => {
      // 使用apply保持原函數(shù)的this指向和參數(shù)
      fn.apply(this, args);
      // 執(zhí)行后重置定時器變量（非必須，但有助于垃圾回收）
      timer = null;
    }, delay);
  };
}

/**
 * 立即執(zhí)行版防抖：首次觸發(fā)立即執(zhí)行，之后進入冷卻期
 * @param {Function} fn    - 需要防抖的原始函數(shù)
 * @param {number}  wait   - 冷卻時間（毫秒）
 * @returns {Function}     - 經(jīng)過防抖處理的新函數(shù)
 */
function debounceImmediate(fn, wait) {
  // 用于保存定時器 ID 的閉包變量
  let timer;

  // 返回一個包裝后的新函數(shù)
  return function (...args) {
    // 如果已經(jīng)有定時器，先清除（重置冷卻期）
    if (timer) clearTimeout(timer);

    // 判斷是否應(yīng)該立即執(zhí)行
    // 當(dāng) timer 為 null/undefined 時（即首次觸發(fā)或已冷卻完畢），shouldCallNow 為 true
    const shouldCallNow = !timer;

    // 設(shè)置新的定時器
    // 定時器到期后把 timer 置空，表示冷卻期結(jié)束
    timer = setTimeout(() => {
      timer = null;
    }, wait);

    // 如果需要立即執(zhí)行，則立即調(diào)用原函數(shù)
    if (shouldCallNow) {
      fn.apply(this, args);
    }
  };
}

/**
 * 定時器版節(jié)流（保證周期末尾執(zhí)行）
 * @param {Function} fn - 需要節(jié)流的函數(shù)
 * @param {number} wait - 執(zhí)行間隔(ms)
 * @returns {Function} - 節(jié)流處理后的函數(shù)
 */
function throttleByTimer(fn, wait) {
    let timer = null;
    
    return function(...args) {
        const context = this;
        
        if (!timer) {
            timer = setTimeout(() => {
                fn.apply(context, args);
                timer = null;
            }, wait);
        }
    };
}

/**
 * 時間戳版節(jié)流（保證周期開始執(zhí)行）
 * @param {Function} fn - 需要節(jié)流的函數(shù)
 * @param {number} wait - 執(zhí)行間隔(ms)
 * @returns {Function} - 節(jié)流處理后的函數(shù)
 */
function throttleByTimestamp(fn, wait) {
    let prev = 0; // 上次執(zhí)行時間戳
    
    return function(...args) {
        const now = Date.now();
        
        if (now - prev >= wait) {
            fn.apply(this, args);
            prev = now;
        }
    };
}