Pular para o conteúdo

Use Bun com Astro

Bun é um completo ambiente de execução e kit de ferramentas JavaScript. Veja a documentação oficial Bun para mais informações.

:::cautionUsar Bun com Astro pode revelar alguns casos extremos. Algumas integrações podem não funcionar como esperado. Consulte a documentação oficial Bun para trabalhar com Astro para detalhes.

Se você tiver problemas usando Bun, por favor abra uma issue diretamente no GitHub de Bun.:::

Pré-requisitos

Criar um novo projeto Astro com Bun

Crie um novo projeto Astro com Bun usando o seguinte comando create-astro:

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

:::tipVocê também pode criar um novo projeto Astro a partir de qualquer repositório Astro existente no GitHub usando a marcação --template:

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

:::

Instalar dependências

Se você está iniciando um novo projeto com bunx create-astro, a CLI usará automaticamente o Bun para instalar as dependências, e você pode pular esta etapa.

Caso contrário, será necessário instalar suas dependências com Bun:

bun install

Adicionar Tipos

Bun publica o pacote @types/bun, que contém os tipos de tempo de execução para Bun.

Instale @types/bun usando o seguinte comando:

bun add -d @types/bun

Usar integrações do Astro

Você pode usar qualquer uma das integrações oficiais do Astro com o comando astro add:

bunx astro add react

Executar Astro com Bun

:::noteUse a marcação --bun na CLI antes de cada comando astro para usar o próprio ambiente de execução Bun em vez do Node.:::

Executar o servidor de desenvolvimento

Para executar o servidor de desenvolvimento usando o Bun como ambiente de execução, use o seguinte comando:

bunx --bun astro dev

Construir seu site com Bun

Para construir seu site usando o Bun como ambiente de execução, use o seguinte comando:

bunx --bun astro build

Astro gerará o seu site no diretório dist/. Em seguida, você pode servir seu site usando o comando preview:

bunx --bun astro preview

Adicionar SSR com Bun

Como Bun possui compatibilidade com a API Node.js, você pode usar qualquer adaptador Astro para renderização no lado do servidor (EN) em seu projeto Astro:

bunx astro add vercel

Testando no Bun

Bun vem com um executor de testes integrado, rápido e compatível com Jest, através do comando bun test. Se você quiser usá-lo, leia a documentação bun test.

No entanto, também é possível usar Cypress ou Playwright para uma abordagem moderna de testes para aplicativos web.

Cypress

Cypress é uma ferramenta de testes front-end que tem a missão de "tornar a experiência de teste agradável e gerar felicidade para os desenvolvedores". Isso permite que você escreva testes de ponta a ponta para o seu site Astro.

Instale Cypress com o seguinte comando:

bun add cypress --dev

Para o restante da configuração e para iniciar seu primeiro teste, siga o processo completo do Cypress no Guia de Testes Astro (EN).

Playwright

Playwright é um framework de testes de ponta a ponta que permite testar seu código Astro em todos os motores de renderização modernos, incluindo Chromium, WebKit e Firefox.

Instale o Playwright usando o seguinte comando:

bun create playwright

Para criar seu primeiro teste Playwright, siga as instruções no Guia de Testes Astro (EN).

Recursos Oficiais

Recursos da Comunidade

Usando Bun com Astro? Adicione sua postagem ou vídeo nesta página!

Contribua Comunidade Sponsor