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.
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 BunCréez un nouveau projet Astro avec Bun en utilisant la commande create-astro
suivante :
Vous pouvez également créer un nouveau projet Astro à partir d’un dépôt Astro GitHub existant en utilisant l’option --template
:
Installer les dépendances
Titre de la section Installer les dépendancesSi 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 :
Ajouter des types
Titre de la section Ajouter des typesBun publie le paquet @types/bun
, contenant les types d’exécution pour Bun.
Installez @types/bun
en utilisant la commande suivante :
Utiliser les intégrations Astro
Titre de la section Utiliser les intégrations AstroVous pouvez également utiliser n’importe laquelle des intégrations officielles d’Astro avec la commande astro add
:
Exécuter Astro avec Bun
Titre de la section Exécuter Astro avec BunUtilisez 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éveloppementPour lancer le serveur de développement en utilisant Bun comme runtime, utilisez la commande suivante :
Construire votre site avec Bun
Titre de la section Construire votre site avec BunPour construire votre site en utilisant Bun comme runtime, utilisez la commande suivante :
Astro produira votre site dans le répertoire dist/
. Ensuite, vous pouvez servir votre site en utilisant la commande preview
:
Ajouter SSR avec Bun
Titre de la section Ajouter SSR avec BunPuisque 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 :
Tester dans Bun
Titre de la section Tester dans BunBun 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 CypressCypress 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 :
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 PlaywrightPlaywright 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 :
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 officiellesRessources communautaires
Titre de la section Ressources communautairesVous 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
- Utiliser Bun avec Astro et Cloudflare Pages - article de blog