1---
2category: State
3related: useDebouncedRefHistory, useRefHistory
4---
5 
6# useThrottledRefHistory
7 
8Shorthand for `useRefHistory` with throttled filter.
9 
10## Usage
11 
12This function takes the first snapshot right after the counter's value was changed and the second with a delay of 1000ms.
13 
14```ts
15import { useThrottledRefHistory } from '@vueuse/core'
16import { shallowRef } from 'vue'
17 
18const counter = shallowRef(0)
19const { history, undo, redo } = useThrottledRefHistory(counter, { deep: true, throttle: 1000 })
20```
21 
22## Type Declarations
23 
24```ts
25export type UseThrottledRefHistoryOptions<Raw, Serialized = Raw> = Omit<
26  UseRefHistoryOptions<Raw, Serialized>,
27  "eventFilter"
28> & {
29  throttle?: MaybeRef<number>
30  trailing?: boolean
31}
32export type UseThrottledRefHistoryReturn<
33  Raw,
34  Serialized = Raw,
35> = UseRefHistoryReturn<Raw, Serialized>
36/**
37 * Shorthand for [useRefHistory](https://vueuse.org/useRefHistory) with throttled filter.
38 *
39 * @see https://vueuse.org/useThrottledRefHistory
40 * @param source
41 * @param options
42 */
43export declare function useThrottledRefHistory<Raw, Serialized = Raw>(
44  source: Ref<Raw>,
45  options?: UseThrottledRefHistoryOptions<Raw, Serialized>,
46): UseThrottledRefHistoryReturn<Raw, Serialized>
47```
48