Utiliser Bun avec Astro

Bun est un moteur d’exécution et une boîte à outils JavaScript tout-en-un. Voir la documentation de Bun pour plus d’informations.

Attention

Bun a récemment publié sa première version stable. Cependant, l’utilisation de Bun avec Astro peut révéler des imperfections. Certaines intégrations peuvent ne pas fonctionner comme prévu. Consultez la documentation officielle de Bun pour travailler avec Astro pour plus de détails.

Si vous rencontrez des problèmes lors de l’utilisation de Bun, veuillez ouvrir un problème sur GitHub avec Bun directement.

Prérequis

Titre de la section Prérequis

• Bun installé localement sur votre machine. Voir les instructions d’installation dans la documentation officielle de Bun.

Créer un nouveau projet Astro avec Bun

Titre de la section Créer un nouveau projet Astro avec Bun

Créez un nouveau projet Astro avec Bun en utilisant la commande create-astro suivante :

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

Astuce

Vous pouvez également créer un nouveau projet Astro à partir d’un dépôt Astro GitHub existant en utilisant l’option --template :

bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal

Installer les dépendances

Titre de la section Installer les dépendances

Si vous démarrez un nouveau projet en utilisant bunx create-astro, le CLI utilisera automatiquement Bun pour installer les dépendances et vous pouvez sauter cette étape.

Sinon, vous devrez installer vos dépendances avec Bun :

bun install

Ajouter des types

Titre de la section Ajouter des types

Bun publie le paquet @types/bun, contenant les types d’exécution pour Bun.

Installez @types/bun en utilisant la commande suivante :

bun add -d @types/bun

Utiliser les intégrations Astro

Titre de la section Utiliser les intégrations Astro

Vous pouvez également utiliser n’importe laquelle des intégrations officielles d’Astro avec la commande astro add :

bunx astro add react

Exécuter Astro avec Bun

Titre de la section Exécuter Astro avec Bun

Note

Utilisez l’option --bun avant chaque commande astro pour utiliser le propre runtime de Bun à la place de Node.

Exécuter le serveur de développement

Titre de la section Exécuter le serveur de développement

Pour lancer le serveur de développement en utilisant Bun comme runtime, utilisez la commande suivante :

bunx --bun astro dev

Construire votre site avec Bun

Titre de la section Construire votre site avec Bun

Pour construire votre site en utilisant Bun comme runtime, utilisez la commande suivante :

bunx --bun astro build

Astro produira votre site dans le répertoire dist/. Ensuite, vous pouvez servir votre site en utilisant la commande preview :

bunx --bun astro preview

Ajouter SSR avec Bun

Titre de la section Ajouter SSR avec Bun

Puisque Bun offre la compatibilité API Node.js, vous pouvez utiliser n’importe quel adaptateur Astro pour le rendu côté serveur dans votre projet Astro :

bunx astro add vercel

Tester dans Bun

Titre de la section Tester dans Bun

Bun est livré avec un programme de test rapide, intégré et compatible avec Jest, via la commande bun test. Si vous souhaitez l’utiliser, lisez la documentation sur bun test.

Cependant, il est également possible d’utiliser Cypress ou Playwright pour une approche moderne des tests d’applications web.

Cypress

Titre de la section Cypress

Cypress est un outil de test frontal dont la mission est de “rendre l’expérience de test agréable et de rendre les développeurs heureux”. Il vous permet d’écrire des tests de bout en bout pour votre site Astro.

Installez Cypress avec la commande suivante :

bun add cypress --dev

Pour le reste de la configuration et pour lancer votre premier test, suivez le reste de la procédure Cypress dans le Guide de test d’Astro.

Playwright

Titre de la section Playwright

Playwright est un framework de test de bout en bout qui vous permet de tester votre code Astro sur tous les moteurs de rendu modernes, y compris Chromium, WebKit et Firefox.

Installez Playwright à l’aide de la commande suivante :

bun create playwright

Pour créer votre premier test Playwright, suivez les instructions pour le reste du processus Playwright dans le Astro Testing Guide.

Ressources officielles

Titre de la section Ressources officielles

• Construire une application avec Astro et Bun

Ressources communautaires

Titre de la section Ressources communautaires

Vous utilisez Bun avec Astro ? Ajoutez votre article de blog ou votre vidéo à cette page !

• Construire un site Cloudflare Pages avec Bun - article de blog