Salta ai contenuti

Usa bun con Astro

Bun è un runtime e toolkit JavaScript all-in-one. Per maggiori informazioni, consulta la documentazione di Bun.

Prerequisiti

Sezione intitolata Prerequisiti

Crea un nuovo progetto Astro con Bun

Sezione intitolata Crea un nuovo progetto Astro con Bun

Crea un nuovo progetto Astro con Bun usando il seguente comando create-astro:

Terminal window
bunx create-astro@latest my-astro-project-using-bun

Installare le dipendenze

Sezione intitolata Installare le dipendenze

Se stai avviando un nuovo progetto usando bunx create-astro, la CLI utilizzerà automaticamente Bun per installare le dipendenze e puoi saltare questo passaggio.

Altrimenti, dovrai installare le dipendenze con Bun:

Terminal window
bun install

Aggiungere i Types

Sezione intitolata Aggiungere i Types

Bun pubblica i tipi di runtime per Bun nel pacchetto bun-types.

Installa bun-types usando il seguente comando:

Terminal window
bun add -d bun-types

Aggiungi il pacchetto ai tuoi types in tsconfig.json:

tsconfig.json
  "compilerOptions": {
    "types": ["bun-types"]
  }

Usare le integrazioni di Astro

Sezione intitolata Usare le integrazioni di Astro

Potresti anche usare qualsiasi integrazione ufficiale di Astro con il comando astro add:

Terminal window
bunx astro add react

Esegui Astro con Bun

Sezione intitolata Esegui Astro con Bun

Esegui il server di sviluppo

Sezione intitolata Esegui il server di sviluppo

Per eseguire il server di sviluppo usando Bun come runtime, usa il seguente comando:

Terminal window
bunx --bun astro dev

Crea il tuo sito con Bun

Sezione intitolata Crea il tuo sito con Bun

Per creare il tuo sito usando Bun come runtime, usa il seguente comando:

Terminal window
bunx --bun astro build

Astro scriverà l’output del tuo sito nella cartella dist/. Puoi servire il tuo sito usando il comando preview:

Terminal window
bunx --bun astro preview

Aggiungere l’SSR con Bun

Sezione intitolata Aggiungere l’SSR con Bun

Poiché Bun supporta la compatibilità con le API di Node.js, puoi usare qualsiasi adattatore Astro per il rendering lato server al tuo progetto Astro:

Terminal window
bunx astro add vercel

Testare con Bun

Sezione intitolata Testare con Bun

Bun è fornito con un test runner integrato, veloce e compatibile con Jest, tramite il comando bun test. Se vuoi usarlo, leggi la documentazione di bun test.

Comunque, è anche possibile usare Cypress o Playwright per un approccio moderno al testing delle web app.

Cypress

Sezione intitolata Cypress

Cypress è un tool di testing front-end e ha come obiettivo “rendere l’esperienza di testing piacevole e generare felicità per gli sviluppatori”. Questo ti permette di scrivere test end-to-end per il tuo sito Astro.

Installa Cypress con il seguente comando:

Terminal window
bun add cypress --dev

Per il resto della configurazione e per iniziare il tuo primo test, segui il resto del processo di Cypress nella Guida al Testing di Astro.

Playwright

Sezione intitolata Playwright

Playwright è un framework di testing end-to-end che ti permette di testare il tuo codice Astro su tutti i moderni motori di rendering, inclusi Chromium, WebKit e Firefox.

Installa Playwright con il seguente comando:

Terminal window
bun create playwright

Per creare il tuo primo test di Playwright, segui le istruzioni per il resto del processo di Playwright nella Guida al Testing di Astro.

Risorse Ufficiali

Sezione intitolata Risorse Ufficiali

Risorse della Community

Sezione intitolata Risorse della Community

Usi Bun con Astro? Aggiungi il tuo blog post o video a questa pagina!