1---
2category: Watch
3---
4 
5# watchAtMost
6 
7`watch` with the number of times triggered.
8 
9## Usage
10 
11Similar to `watch` with an extra option `count` which set up the number of times the callback function is triggered. After the count is reached, the watch will be stopped automatically.
12 
13```ts
14import { watchAtMost } from '@vueuse/core'
15 
16watchAtMost(
17  source,
18  () => { console.log('trigger!') }, // triggered it at most 3 times
19  {
20    count: 3, // the number of times triggered
21  },
22)
23```
24 
25## Type Declarations
26 
27```ts
28export interface WatchAtMostOptions<
29  Immediate,
30> extends WatchWithFilterOptions<Immediate> {
31  count: MaybeRefOrGetter<number>
32}
33export interface WatchAtMostReturn {
34  stop: WatchStopHandle
35  pause: () => void
36  resume: () => void
37  count: ShallowRef<number>
38}
39export declare function watchAtMost<
40  T extends Readonly<MultiWatchSources>,
41  Immediate extends Readonly<boolean> = false,
42>(
43  sources: [...T],
44  cb: WatchCallback<MapSources<T>, MapOldSources<T, Immediate>>,
45  options: WatchAtMostOptions<Immediate>,
46): WatchAtMostReturn
47export declare function watchAtMost<
48  T,
49  Immediate extends Readonly<boolean> = false,
50>(
51  sources: WatchSource<T>,
52  cb: WatchCallback<T, Immediate extends true ? T | undefined : T>,
53  options: WatchAtMostOptions<Immediate>,
54): WatchAtMostReturn
55```
56