watchPausable

v0.0.15testeddemo

A `watch` whose execution can be paused and resumed on demand via a pausable event filter.

Example

const count = ref(0);
const { pause, resume, isActive } = watchPausable(count, (value) => {
  console.log('changed to', value);
});

pause();
count.value++; // callback not called
resume();
count.value++; // callback called

Demo

Loading demo…

Signatures

export function watchPausable<T extends Readonly<MultiWatchSources>, Immediate extends Readonly<boolean> = false>(
  sources: [...T],
  cb: WatchCallback<MapSources<T>, MapOldSources<T, Immediate>>,
  options?: UseWatchPausableOptions<Immediate>,
): UseWatchPausableReturn;

export function watchPausable<T, Immediate extends Readonly<boolean> = false>(
  source: WatchSource<T>,
  cb: WatchCallback<T, Immediate extends true ? T | undefined : T>,
  options?: UseWatchPausableOptions<Immediate>,
): UseWatchPausableReturn;

export function watchPausable<T extends object, Immediate extends Readonly<boolean> = false>(
  source: T,
  cb: WatchCallback<T, Immediate extends true ? T | undefined : T>,
  options?: UseWatchPausableOptions<Immediate>,
): UseWatchPausableReturn;

Type Parameters

Immediateextends Readonly<boolean>= false

Parameters

Parameter	Type	Default	Description
`source`	`any`	—	The watch source (ref, getter, reactive object, or an array of sources)
`cb`	`any`	—	The callback invoked when an active source changes
`options`?	`UseWatchPausableOptions<Immediate>`	`{}`	Watch options plus `eventFilter` and `initialState`

Returns

UseWatchPausableReturn`{ stop, pause, resume, isActive }`