/**
 * @description 防抖函數(shù)
 * @param {Function} fn
 * @param {number} delay
 * @param {boolean} immediate
 * @returns {Function}
 */
export function debounce<T extends (...args: any[]) => any>(
  fn: T,
  delay: number,
  immediate: boolean = false
): T & { cancel(): void } {
  let timerId: ReturnType<typeof setTimeout> | null = null; // 存儲(chǔ)定時(shí)器
  // 定義一個(gè)cancel辦法,用于勾銷(xiāo)防抖
  const cancel = (): void => {
    if (timerId) {
      clearTimeout(timerId);
      timerId = null;
    }
  };
  const debounced = function (
    this: ThisParameterType<T>,
    ...args: Parameters<T>
  ): void {
    const context = this;
    if (timerId) {
      cancel();
    }
    if (immediate) {
      // 如果 immediate 為 true 并且沒(méi)有正在期待執(zhí)行的定時(shí)器，立刻執(zhí)行指標(biāo)函數(shù)
      if (!timerId) {
        fn.apply(context, args);
      }
      // 設(shè)置定時(shí)器，在延遲時(shí)間后將 timeoutId 設(shè)為 null
      timerId = setTimeout(() => {
        timerId = null;
      }, delay);
    } else {
      // 設(shè)置定時(shí)器，在延遲時(shí)間后執(zhí)行指標(biāo)函數(shù)
      timerId = setTimeout(() => {
        fn.apply(context, args);
      }, delay);
    }
  };
  // 將 cancel 辦法附加到 debounced 函數(shù)上
  (debounced as any).cancel = cancel;
  return debounced as T & { cancel(): void };
}

/**
 * 節(jié)流函數(shù)
 * @param func 要進(jìn)行節(jié)流的指標(biāo)函數(shù)
 * @param delay 節(jié)流的工夫距離（毫秒）
 * @returns 返回一個(gè)通過(guò)節(jié)流解決的函數(shù)
 */
export function throttle<T extends (...args: any[]) => any>(
  fn: T,
  delay: number
): T {
  let lastCall: number | null = null; // 上一次調(diào)用的工夫戳
  return function (
    this: ThisParameterType<T>,
    ...args: Parameters<T>
  ): ReturnType<T> | void {
    const now = Date.now(); //以后工夫戳
    // 如果之前沒(méi)有調(diào)用過(guò),或者工夫距離超過(guò)了設(shè)定的值,執(zhí)行指標(biāo)函數(shù)
    if (!lastCall || now - lastCall >= delay) {
      lastCall = now;
      return fn.apply(this, args);
    }
  } as T;
}