Saltearse al contenido

Usa Bun con Astro

Bun es un entorno y conjunto de herramientas de JavaScript todo en uno. Consulta la documentación de Bun para obtener más información.

Prerrequisitos

Sección titulada Prerrequisitos

Crea un nuevo proyecto de Astro con Bun

Sección titulada Crea un nuevo proyecto de Astro con Bun

Crea un nuevo proyecto de Astro con Bun utilizando el siguiente comando create-astro:

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

Instalar dependencias

Sección titulada Instalar dependencias

Si estás comenzando un nuevo proyecto utilizando bunx create-astro, la CLI utilizará automáticamente Bun para instalar las dependencias y puedes omitir este paso.

De lo contrario, deberás instalar tus dependencias con Bun:

Terminal window
bun install

Agrega Tipos

Sección titulada Agrega Tipos

Bun publica el paquete bun-types, que contiene los tipos en runtime para Bun.

Instala bun-types utilizando el siguiente comando:

Terminal window
bun add -d bun-types

Agrega el paquete a tus tipos en tsconfig.json.

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

Utilizando las integraciones de Astro

Sección titulada Utilizando las integraciones de Astro

También puedes utilizar cualquiera de las integraciones oficiales de Astro con el comando astro add:

Terminal window
bunx astro add react

Ejecuta Astro con Bun

Sección titulada Ejecuta Astro con Bun

Ejecuta el servidor de desarrollo

Sección titulada Ejecuta el servidor de desarrollo

Para ejecutar el servidor de desarrollo utilizando Bun como el entorno de ejecución, utiliza el siguiente comando:

Terminal window
bunx --bun astro dev

Construyendo tu sitio con Bun

Sección titulada Construyendo tu sitio con Bun

Para construir tu sitio utilizando Bun como el entorno de ejecución, utiliza el siguiente comando:

Terminal window
bunx --bun astro build

Astro generará la salida de tu sitio en el directorio dist/. Luego, puedes servir tu sitio utilizando el comando preview:

Terminal window
bunx --bun astro preview

Agrega SSR con Bun

Sección titulada Agrega SSR con Bun

Como Bun es compatible con la API de Node.js, puedes usar cualquier adaptador Astro para server-side rendering en tu proyecto Astro:

Terminal window
bunx astro add vercel

Testing en Bun

Sección titulada Testing en Bun

Bun incluye un ejecutor de tests rápido, integrado y compatible con Jest a través del comando bun test. Si quieres usarlo consulta la documentación de bun test.

Sin embargo, también es posible utilizar Cypress o Playwright para un enfoque moderno de los tests de aplicaciones web.

Cypress

Sección titulada Cypress

Cypress es una herramienta de tests front-end y tiene la misión de “hacer agradable la experiencia de los tests y generar felicidad en los desarrolladores”. Esto le permite escribir tests de extremo a extremo para tu sitio Astro.

Instala Cypress con el siguiente comando:

Terminal window
bun add cypress --dev

Para el resto de la configuración y para iniciar tu primer test, sigue el resto del proceso de Cypress en la Guía de testing en Astro.

Playwright

Sección titulada Playwright

Playwright es un framework de tests de extremo a extremo que te permite probar tu código Astro en todos los motores de renderizado modernos, incluidos Chromium, WebKit y Firefox.

Instala Playwright utilizando el siguiente comando:

Terminal window
bun create playwright

Para crear tu primer test en Playwright, sigue las instrucciones para el resto del proceso Playwright en la Guía de testing en Astro.

Recursos Oficiales

Sección titulada Recursos Oficiales

Recursos de la Comunidad

Sección titulada Recursos de la Comunidad

¿Estás usando Bun con Astro? ¡Agrega tu entrada de blog o video a esta página!