La modalità watch è una funzionalità che ricarica automaticamente la tua applicazione quando i file nel tuo progetto cambiano. È utile durante lo sviluppo quando vuoi vedere le modifiche in tempo reale senza riavviare manualmente il server.

Per abilitare la modalità watch, passa il flag --watch al comando bun.

bun --watch server.ts

Questo avvierà il server e lo terrà in esecuzione. Quando un file viene modificato, il server verrà riavviato automaticamente.

---

Ricarica a caldo

Bun supporta la ricarica a caldo (HMR) per i file HTML importati. Quando modifichi un file HTML, il browser si aggiornerà automaticamente senza un ricaricamento completo della pagina.

Per abilitare la ricarica a caldo per i file HTML:

bun --hot --watch server.ts

Il flag --hot abilita la ricarica a caldo per i file HTML importati. Quando un file HTML viene modificato, Bun invierà un segnale al browser per aggiornare la pagina senza un ricaricamento completo.

---

File da watchare

Per impostazione predefinita, Bun watcha tutti i file nella directory di lavoro corrente e nelle sue sottodirectory. Puoi specificare quali file o directory watchare usando il flag --watch.

bun --watch --watch-dir src server.ts

Questo farà in modo che Bun watchi solo la directory src.

Puoi anche specificare più directory:

bun --watch --watch-dir src --watch-dir tests server.ts

---

Ignorare file

Puoi ignorare file o directory specifiche usando il flag --watch-ignore.

bun --watch --watch-ignore node_modules server.ts

Questo ignorerà la directory node_modules durante il watch.

Puoi anche usare un file .gitignore per specificare i file da ignorare:

bun --watch --watch-gitignore server.ts

Questo userà le regole nel file .gitignore per determinare quali file ignorare.

---

Opzioni avanzate

Riavvio ritardato

Puoi ritardare il riavvio del server dopo una modifica usando il flag --watch-delay.

bun --watch --watch-delay 1000 server.ts

Questo ritarderà il riavvio di 1000 millisecondi (1 secondo) dopo una modifica.

Ricarica completa

Per impostazione predefinina, Bun tenta di ricaricare solo i moduli modificati. Per forzare un riavvio completo:

bun --watch --watch-force-restart server.ts

Questo forzerà un riavvio completo del server ogni volta che un file viene modificato.

Esecuzione di script

Puoi anche eseguire script prima o dopo il riavvio usando i flag --watch-restart-script e --watch-exit-script.

bun --watch --watch-restart-script restart.sh server.ts

Questo eseguirà lo script restart.sh ogni volta che il server viene riavviato.

---

Esempio

Ecco un esempio di come usare la modalità watch con un server Bun:

bun --watch --hot --watch-dir src server.ts

Questo avvierà il server in modalità watch, abiliterà la ricarica a caldo per i file HTML, e watchera solo la directory src.

---

Riferimento

bun --watch [opzioni] <file>

Opzioni

Opzione	Descrizione
--watch	Abilita la modalità watch
--hot	Abilita la ricarica a caldo per i file HTML
--watch-dir <dir>	Specifica una directory da watchare
--watch-ignore <pattern>	Ignora file o directory specifiche
--watch-gitignore	Usa le regole del file .gitignore
--watch-delay <ms>	Ritarda il riavvio dopo una modifica
--watch-force-restart	Forza un riavvio completo
--watch-restart-script <script>	Esegue uno script prima del riavvio
--watch-exit-script <script>	Esegue uno script prima dell'uscita