1001Ferramentas
🚀Dev

Gerador esbuild Config

Gera um esbuild.config.js pronto para builds rápidos, com entry point, bundle, minificação, sourcemap e target já definidos. O formato de saída fica no padrão do esbuild.



  

Script de build esbuild pronto para rodar

O esbuild é rápido e tem uma pegadinha que pega quase todo mundo na primeira vez: ele não procura nenhum arquivo de configuração sozinho. Ou você empilha flags na linha de comando até o script do package.json virar um parágrafo, ou escreve um pequeno script de build em JavaScript. Esta página entrega esse script já escrito.

O bloco é fixo, sem campos, e aparece na tela assim que a página carrega. Ele faz require('esbuild') e chama esbuild.build com entryPoints src/index.js, bundle true, outfile dist/bundle.js, minify true, sourcemap true, target es2020 e platform browser, terminando com um catch que sai com código 1. Salve como esbuild.config.js e rode com node esbuild.config.js, ou coloque isso no seu script de build.

Três coisas para conferir. O arquivo usa require, então ele quebra se o seu package.json tiver type: module; nesse caso renomeie para .cjs ou troque por import. platform browser faz módulos nativos do Node, como fs e path, não resolverem, então mude para node em ferramenta de linha de comando. E não há watch: desde a versão 0.17 isso mora na API de contexto, com esbuild.context e ctx.watch. O texto é montado no navegador.

Perguntas frequentes

O esbuild lê esse arquivo automaticamente?
Não. Ele é um script comum de Node que chama a API do esbuild. Você precisa executá-lo, por exemplo com node esbuild.config.js ou via npm run build.
Como faço o modo watch?
Troque esbuild.build por esbuild.context com o mesmo objeto de opções e chame await ctx.watch(). O antigo watch: true foi removido na 0.17.
Como gerar um bundle ESM?
Acrescente format: 'esm' às opções e use uma extensão .mjs no outfile. Sem essa chave, com platform browser, o esbuild gera um IIFE.

Ferramentas Relacionadas