Skip to content
On this page

refDebounced

Category
Export Size
415 B
Last Changed
2 months ago
Alias
useDebouncedebouncedRef
Related

Debounce execution of a ref value.

Demo

Delay is set to 1000ms for this demo.

Debounced:

Times Updated: 0

Usage

js
import { refDebounced } from '@vueuse/core'

const input = ref('foo')
const debounced = refDebounced(input, 1000)

input.value = 'bar'
console.log(debounced.value) // 'foo'

await sleep(1100)

console.log(debounced.value) // 'bar'
import { refDebounced } from '@vueuse/core'

const input = ref('foo')
const debounced = refDebounced(input, 1000)

input.value = 'bar'
console.log(debounced.value) // 'foo'

await sleep(1100)

console.log(debounced.value) // 'bar'

You can also pass an optional 3rd parameter including maxWait option. See useDebounceFnfor details.

Type Declarations

typescript
/**
 * Debounce updates of a ref.
 *
 * @return A new debounced ref.
 */
export declare function refDebounced<T>(
  value: Ref<T>,
  ms?: MaybeComputedRef<number>,
  options?: DebounceFilterOptions
): Readonly<Ref<T>>
export { refDebounced as useDebounce, refDebounced as debouncedRef }
/**
 * Debounce updates of a ref.
 *
 * @return A new debounced ref.
 */
export declare function refDebounced<T>(
  value: Ref<T>,
  ms?: MaybeComputedRef<number>,
  options?: DebounceFilterOptions
): Readonly<Ref<T>>
export { refDebounced as useDebounce, refDebounced as debouncedRef }

Source

SourceDemoDocs

Contributors

Anthony Fu
Dominik Klein

Changelog

v9.4.0 on 10/25/2022
ce3dc - feat: use MaybeComputedRef for ms (#2337)
v6.9.0 on 11/14/2021
c5e01 - feat(debouncedRef): new alias
v6.8.0 on 11/6/2021
529ac - feat(useDebounce & useDebounceFn): accept maxMs parameter (#877)

Released under the MIT License.