Skip to content

useThrottledRefHistory

Category
Export Size
1.47 kB
Last Changed
6 months ago
Related

Shorthand for useRefHistory with throttled filter.

Demo

Count: 0
/
Delay (in ms):

History (limited to 10 records for demo)
2025-08-18 01:10:01{ value: 0 }

Usage

This function takes the first snapshot right after the counter's value was changed and the second with a delay of 1000ms.

ts
import { 
useThrottledRefHistory
} from '@vueuse/core'
import {
shallowRef
} from 'vue'
const
counter
=
shallowRef
(0)
const {
history
,
undo
,
redo
} =
useThrottledRefHistory
(
counter
, {
deep
: true,
throttle
: 1000 })

Type Declarations

ts
export type 
UseThrottledRefHistoryOptions
<
Raw
,
Serialized
=
Raw
> =
Omit
<
UseRefHistoryOptions
<
Raw
,
Serialized
>,
"eventFilter" > & {
throttle
?:
MaybeRef
<number>
trailing
?: boolean
} export type
UseThrottledRefHistoryReturn
<
Raw
,
Serialized
=
Raw
,
> =
UseRefHistoryReturn
<
Raw
,
Serialized
>
/** * Shorthand for [useRefHistory](https://vueuse.org/useRefHistory) with throttled filter. * * @see https://vueuse.org/useThrottledRefHistory * @param source * @param options */ export declare function
useThrottledRefHistory
<
Raw
,
Serialized
=
Raw
>(
source
:
Ref
<
Raw
>,
options
?:
UseThrottledRefHistoryOptions
<
Raw
,
Serialized
>,
):
UseThrottledRefHistoryReturn
<
Raw
,
Serialized
>

Source

SourceDemoDocs

Contributors

Anthony Fu
Roman Harmyder
IlyaL
Anthony Fu
Robin
OrbisK
Jelf
Bodo Graumann
wheat

Changelog

v12.8.0 on
7432f - feat(types): deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native (#4636)
v12.0.0-beta.1 on
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.7.0 on
fccf2 - feat: upgrade deps (#3614)

Released under the MIT License.

FREE WEEKEND
48 Hours of Unlimited Official Vue.js Certification Training
Reserve Your Spot
23-24 August