Interface: WatcherFileWatcherOptions

Defined in: options/input-options.ts:57

Properties

compareContentsForPolling?

• Type: boolean
• Optional

Defined in: options/input-options.ts:83

Whether to compare file contents for poll-based watchers. When enabled, poll watchers will check file contents to determine if they actually changed.

This option is only used when usePolling is true.

Default

false

---

debounceDelay?

• Type: number
• Optional

Defined in: options/input-options.ts:95

Debounce delay in milliseconds for fs-level debounced watchers. Only used when useDebounce is true.

Default

10

---

debounceTickRate?

• Type: number
• Optional

Defined in: options/input-options.ts:101

Tick rate in milliseconds for the debouncer's internal polling. Only used when useDebounce is true. When undefined, auto-selects 1/4 of debounceDelay.

---

pollInterval?

• Type: number
• Optional

Defined in: options/input-options.ts:74

Interval between each poll in milliseconds.

This option is only used when usePolling is true.

Default

100

---

useDebounce?

• Type: boolean
• Optional

Defined in: options/input-options.ts:89

Whether to use debounced event delivery at the filesystem level. This coalesces rapid filesystem events before they reach the build coordinator.

Default

false

---

usePolling?

• Type: boolean
• Optional

Defined in: options/input-options.ts:66

Whether to use polling-based file watching instead of native OS events.

Polling is useful for environments where native FS events are unreliable, such as network mounts, Docker volumes, or WSL2.

Default

false