> For the complete documentation index, see [llms.txt](https://laterly.gitbook.io/hooks-vue3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://laterly.gitbook.io/hooks-vue3/useoncewatch.md).

# useOnceWatch

#### 基础用法

```html
<template>
  <div>Hello World! {{ count }}</div>
  <button @click="count++">Add</button>
</template>

<script setup lang="ts">
import { ref } from "vue";
import { useOnceWatch } from "hooks-vue3";
const count = ref<number>(0);
useOnceWatch(count, () => {
  console.log("只进来一次，然后自动停止监听");
});
</script>
```

### API

```typescript
useOnceWatch(count,callback,options);
```

### 参数TS类型

```typescript


import type { WatchCallback, WatchOptions, WatchSource } from 'vue';

function useOnceWatch<T = any, Immediate extends Readonly<boolean> = false>(
  source: T | WatchSource<T>,
  cb: WatchCallback<T>,
  options?: WatchOptions<Immediate>,
)
```