watchOnce
Shorthand for watching value with { once: true }
. Once the callback fires once, the watcher will be stopped. See Vue's docs for full details.
Usage
Similar to watch
, but with { once: true }
ts
import { watchOnce } from '@vueuse/core'
watchOnce(source, () => {
// triggers only once
console.log('source changed!')
})
Type Declarations
typescript
export declare function watchOnce<T extends Readonly<WatchSource<unknown>[]>>(
source: [...T],
cb: WatchCallback<MapSources<T>, MapOldSources<T, true>>,
options?: Omit<WatchOptions<true>, "once">,
): WatchStopHandle
export declare function watchOnce<T>(
source: WatchSource<T>,
cb: WatchCallback<T, T | undefined>,
options?: Omit<WatchOptions<true>, "once">,
): WatchStopHandle
export declare function watchOnce<T extends object>(
source: T,
cb: WatchCallback<T, T | undefined>,
options?: Omit<WatchOptions<true>, "once">,
): WatchStopHandle