89 lines
2.5 KiB
TypeScript
89 lines
2.5 KiB
TypeScript
|
// @ts-nocheck
|
|||
|
|
/**
|
|||
|
|
* 节流函数，用于限制函数的调用频率
|
|||
|
|
* @param fn 要进行节流的函数
|
|||
|
|
* @param interval 两次调用之间的最小间隔时间
|
|||
|
|
* @returns 节流后的函数
|
|||
|
|
*/
|
|||
|
|
export type ThrottleOptions = {
|
|||
|
|
/**
|
|||
|
|
* 是否在节流开始时立即执行
|
|||
|
|
* @default true
|
|||
|
|
*/
|
|||
|
|
leading ?: boolean;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 是否在节流结束后执行最后一次调用
|
|||
|
|
* @default true
|
|||
|
|
*/
|
|||
|
|
trailing ?: boolean;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 节流函数，限制函数在一定时间内只能执行一次
|
|||
|
|
* @param func 需要节流的函数
|
|||
|
|
* @param wait 节流间隔时间（毫秒）
|
|||
|
|
* @param options 配置选项
|
|||
|
|
* @param options.leading 是否在节流开始时立即执行（默认 true）
|
|||
|
|
* @param options.trailing 是否在节流结束时执行最后一次调用（默认 true）
|
|||
|
|
* @returns 返回节流后的函数
|
|||
|
|
*/
|
|||
|
|
// #ifndef APP-ANDROID
|
|||
|
|
export function throttle<T extends (...args : any[]) => any>(
|
|||
|
|
func : T,
|
|||
|
|
wait : number,
|
|||
|
|
options : ThrottleOptions = {}
|
|||
|
|
) : (...args : Parameters<T>) => void {
|
|||
|
|
let lastCallTime = 0;
|
|||
|
|
let timerId : ReturnType<typeof setTimeout> | null = null;
|
|||
|
|
const { leading = true, trailing = true } = options;
|
|||
|
|
return function (...args : Parameters<T>) {
|
|||
|
|
const now = Date.now();
|
|||
|
|
const timeSinceLastCall = now - lastCallTime;
|
|||
|
|
// 1. 如果 leading=true 且距离上次调用超过 wait，立即执行
|
|||
|
|
if (leading && timeSinceLastCall >= wait) {
|
|||
|
|
lastCallTime = now;
|
|||
|
|
func.apply(this, args);
|
|||
|
|
}
|
|||
|
|
// 2. 如果 trailing=true，设置定时器在 wait 时间后执行最后一次调用
|
|||
|
|
else if (trailing && !timerId) {
|
|||
|
|
timerId = setTimeout(() => {
|
|||
|
|
lastCallTime = Date.now();
|
|||
|
|
func.apply(this, args);
|
|||
|
|
timerId = null;
|
|||
|
|
}, wait - timeSinceLastCall);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
// #endif
|
|||
|
|
|
|||
|
|
// #ifdef APP-ANDROID
|
|||
|
|
export function throttle<T extends any|null>(
|
|||
|
|
func: (args : T) => void,
|
|||
|
|
wait : number,
|
|||
|
|
options : ThrottleOptions = {}
|
|||
|
|
) : (args : T) => void {
|
|||
|
|
let lastCallTime = 0;
|
|||
|
|
let timerId = -1;
|
|||
|
|
const { leading = true, trailing = true } = options;
|
|||
|
|
return function (args : T) {
|
|||
|
|
const now = Date.now();
|
|||
|
|
const timeSinceLastCall = now - lastCallTime;
|
|||
|
|
// 1. 如果 leading=true 且距离上次调用超过 wait，立即执行
|
|||
|
|
if (leading && timeSinceLastCall >= wait) {
|
|||
|
|
lastCallTime = now;
|
|||
|
|
func(args);
|
|||
|
|
}
|
|||
|
|
// 2. 如果 trailing=true，设置定时器在 wait 时间后执行最后一次调用
|
|||
|
|
else if (trailing && timerId > -1) {
|
|||
|
|
timerId = setTimeout(() => {
|
|||
|
|
lastCallTime = Date.now();
|
|||
|
|
func(args);
|
|||
|
|
timerId = -1;
|
|||
|
|
}, wait - timeSinceLastCall);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
// #endif
|