mirror of
https://github.com/oven-sh/bun
synced 2026-02-02 15:08:46 +00:00
65a215bb4e
This updates the documentation for `fs.watch()` to use `relativePath` instead of `filename` in the recursive example, following the same convention from PR #23990. When `recursive: true` is set on `fs.watch()`, the callback receives a relative path to the changed file rather than just a simple filename. Using `relativePath` as the parameter name makes this distinction clearer to users. **Related to:** https://github.com/oven-sh/bun/pull/23990 Co-authored-by: Michael H <git@riskymh.dev>
67 lines
1.8 KiB
Plaintext
67 lines
1.8 KiB
Plaintext
---
|
|
title: Watch a directory for changes
|
|
sidebarTitle: Watch directory
|
|
mode: center
|
|
---
|
|
|
|
Bun implements the `node:fs` module, including the `fs.watch` function for listening for file system changes.
|
|
|
|
This code block listens for changes to files in the current directory. By default this operation is _shallow_, meaning that changes to files in subdirectories will not be detected.
|
|
|
|
```ts
|
|
import { watch } from "fs";
|
|
|
|
const watcher = watch(import.meta.dir, (event, filename) => {
|
|
console.log(`Detected ${event} in ${filename}`);
|
|
});
|
|
```
|
|
|
|
---
|
|
|
|
To listen to changes in subdirectories, pass the `recursive: true` option to `fs.watch`.
|
|
|
|
```ts
|
|
import { watch } from "fs";
|
|
|
|
const watcher = watch(import.meta.dir, { recursive: true }, (event, relativePath) => {
|
|
console.log(`Detected ${event} in ${relativePath}`);
|
|
});
|
|
```
|
|
|
|
---
|
|
|
|
Using the `node:fs/promises` module, you can listen for changes using `for await...of` instead of a callback.
|
|
|
|
```ts
|
|
import { watch } from "fs/promises";
|
|
|
|
const watcher = watch(import.meta.dir);
|
|
for await (const event of watcher) {
|
|
console.log(`Detected ${event.eventType} in ${event.filename}`);
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
To stop listening for changes, call `watcher.close()`. It's common to do this when the process receives a `SIGINT` signal, such as when the user presses Ctrl-C.
|
|
|
|
```ts
|
|
import { watch } from "fs";
|
|
|
|
const watcher = watch(import.meta.dir, (event, filename) => {
|
|
console.log(`Detected ${event} in ${filename}`);
|
|
});
|
|
|
|
process.on("SIGINT", () => {
|
|
// close watcher when Ctrl-C is pressed
|
|
console.log("Closing watcher...");
|
|
watcher.close();
|
|
|
|
process.exit(0);
|
|
});
|
|
```
|
|
|
|
---
|
|
|
|
Refer to [API > Binary data > Typed arrays](https://bun.com/docs/api/binary-data#typedarray) for more information on working with `Uint8Array` and other binary data formats in Bun.
|