Skip to content

usePrevious ​

Category
Export Size
260 B
Last Changed
yesterday

Holds the previous value of a ref.

Usage ​

ts
import { usePrevious } from '@vueuse/core'
import { ref } from 'vue'

const counter = ref('Hello')
const previous = usePrevious(counter)

console.log(previous.value) // undefined

counter.value = 'World'

console.log(previous.value) // Hello

Type Declarations ​

typescript
/**
 * Holds the previous value of a ref.
 *
 * @see   {@link https://vueuse.org/usePrevious}
 */
export declare function usePrevious<T>(
  value: MaybeRefOrGetter<T>,
): Readonly<Ref<T | undefined>>
export declare function usePrevious<T>(
  value: MaybeRefOrGetter<T>,
  initialValue: T,
): Readonly<Ref<T>>

Source ​

Source • Docs

Contributors ​

Anthony Fu
Anthony Fu

Changelog ​

v12.0.0-beta.1 on 11/21/2024
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.0.0-beta.4 on 4/13/2023
4d757 - feat(types)!: rename MaybeComputedRef to MaybeRefOrGetter
10e98 - feat(toRef)!: rename resolveRef to toRef
v9.12.0 on 1/29/2023
e101f - feat: new function

Released under the MIT License.