| Category | Utilities |
|---|---|
| Export Size | 401 B |
| Last Changed | 2 weeks ago |
| Related |
refDebouncedrefThrottleduseDebounceFn
|
Throttle execution of a function. Especially useful for rate limiting execution of handlers on events like resize and scroll.
Throttle is a spring that throws balls: after a ball flies out it needs some time to shrink back, so it cannot throw any more balls unless it's ready.
import { useThrottleFn } from '@vueuse/core'
const throttledFn = useThrottleFn(() => {
// do something, it will be called at most 1 time per second
}, 1000)
window.addEventListener('resize', throttledFn)
/** * Throttle execution of a function. Especially useful for rate limiting * execution of handlers on events like resize and scroll. * * @param fn A function to be executed after delay milliseconds. The `this` context and all arguments are passed through, as-is, * to `callback` when the throttled-function is executed. * @param ms A zero-or-greater delay in milliseconds. For event callbacks, values around 100 or 250 (or even higher) are most useful. * * @param [trailing=false] if true, call fn again after the time is up * * @param [leading=true] if true, call fn on the leading edge of the ms timeout * * @param [rejectOnCancel=false] if true, reject the last call if it's been cancel * * @return A new, throttled, function. */ export declare function useThrottleFn<T extends FunctionArgs>( fn: T, ms?: MaybeRefOrGetter<number>, trailing?: boolean, leading?: boolean, rejectOnCancel?: boolean ): PromisifyFn<T>
© 2019-present Anthony Fu
Licensed under the MIT License.
https://vueuse.org/shared/useThrottleFn/