Uso da CLI bun run

bun run <arquivo ou script>

Opções Gerais de Execução

--silentboolean

Não imprima o comando do script

--if-presentboolean

Saia sem erro se o ponto de entrada não existir

--evalstring

Avalie o argumento como um script. Apelido: -e

--printstring

Avalie o argumento como um script e imprima o resultado. Apelido: -p

--helpboolean

Exiba este menu e saia. Apelido: -h

Gerenciamento de Workspace

--elide-linesnumber default: 10

Número de linhas de saída do script mostradas ao usar --filter (padrão: 10). Defina como 0 para mostrar todas as linhas

--filterstring

Execute um script em todos os pacotes do workspace que correspondem ao padrão. Apelido: -F

--workspacesboolean

Execute um script em todos os pacotes do workspace (do campo workspaces no package.json)

Controle de Runtime e Processo

--bunboolean

Force um script ou pacote a usar o runtime do Bun em vez do Node.js (via link simbólico do node). Apelido: -b

--shellstring

Controle o shell usado para scripts do package.json. Suporta bun ou system

--smolboolean

Use menos memória, mas execute a coleta de lixo com mais frequência

--expose-gcboolean

Exponha gc() no objeto global. Não tem efeito em Bun.gc()

--no-deprecationboolean

Suprima todo o relatório de deprecação personalizada

--throw-deprecationboolean

Determine se avisos de deprecação resultam em erros

--titlestring

Defina o título do processo

--zero-fill-buffersboolean

Booleano para forçar Buffer.allocUnsafe(size) a ser preenchido com zeros

--no-addonsboolean

Lance um erro se process.dlopen for chamado e desabilite a condição de exportação node-addons

--unhandled-rejectionsstring

Um dos strict, throw, warn, none ou warn-with-error-code

--console-depthnumber default: 2

Defina a profundidade padrão para inspeção de objetos do console.log (padrão: 2)

Fluxo de Trabalho de Desenvolvimento

--watchboolean

Reinicie automaticamente o processo quando arquivos mudarem

--hotboolean

Habilite recarregamento automático no runtime do Bun, test runner ou bundler

--no-clear-screenboolean

Desabilite a limpeza da tela do terminal ao recarregar quando --hot ou --watch estiver habilitado

Depuração

--inspectstring

Ative o depurador do Bun

--inspect-waitstring

Ative o depurador do Bun, aguarde uma conexão antes de executar

--inspect-brkstring

Ative o depurador do Bun, defina breakpoint na primeira linha de código e aguarde

Resolução de Dependências e Módulos

--preloadstring

Importe um módulo antes de outros módulos serem carregados. Apelido: -r

--requirestring

Apelido de --preload, para compatibilidade com Node.js

--importstring

Apelido de --preload, para compatibilidade com Node.js

--no-installboolean

Desabilite instalação automática no runtime do Bun

--installstring default: auto

Configure o comportamento de instalação automática. Um dos auto (padrão, instala automaticamente quando não há node_modules), fallback (apenas pacotes ausentes), force (sempre)

-iboolean

Instale automaticamente dependências durante a execução. Equivalente a --install=fallback

--prefer-offlineboolean

Pule verificações de obsolescência para pacotes no runtime do Bun e resolva do disco

--prefer-latestboolean

Use as versões mais recentes correspondentes de pacotes no runtime do Bun, sempre verificando npm

--conditionsstring

Passe condições personalizadas para resolução

--main-fieldsstring

Campos principais para procurar no package.json. Padrão dependente de --target

--preserve-symlinksboolean

Preserve symlinks ao resolver arquivos

--preserve-symlinks-mainboolean

Preserve symlinks ao resolver o ponto de entrada principal

--extension-orderstring default: .tsx,.ts,.jsx,.js,.json

Padrão: .tsx,.ts,.jsx,.js,.json

Transpilação e Recursos de Linguagem

--tsconfig-overridestring

Especifique tsconfig.json personalizado. Padrão $cwd/tsconfig.json

--definestring

Substitua K:V durante a análise, ex. --define process.env.NODE_ENV:"development". Valores são analisados como JSON. Apelido: -d

--dropstring

Remova chamadas de função, ex. --drop=console remove todas as chamadas console.*

--loaderstring

Analise arquivos com .ext:loader, ex. --loader .js:jsx. Loaders válidos: js, jsx, ts, tsx, json, toml, text, file, wasm, napi. Apelido: -l

--no-macrosboolean

Desabilite a execução de macros no bundler, transpilador e runtime

--jsx-factorystring

Altera a função chamada ao compilar elementos JSX usando o runtime JSX clássico

--jsx-fragmentstring

Altera a função chamada ao compilar fragmentos JSX

--jsx-import-sourcestring default: react

Declara o especificador do módulo a ser usado para importar as funções de fábrica jsx e jsxs. Padrão: react

--jsx-runtimestring default: automatic

automatic (padrão) ou classic

--jsx-side-effectsboolean

Trate elementos JSX como tendo efeitos colaterais (desabilite anotações pure)

--ignore-dce-annotationsboolean

Ignore anotações de tree-shaking como @__PURE__

Rede e Segurança

--portnumber

Defina a porta padrão para Bun.serve

--fetch-preconnectstring

Pré-conecte a uma URL enquanto o código está carregando

--max-http-header-sizenumber default: 16384

Defina o tamanho máximo de cabeçalhos HTTP em bytes. Padrão é 16KiB

--dns-result-orderstring default: verbatim

Defina a ordem padrão dos resultados de lookup DNS. Ordens válidas: verbatim (padrão), ipv4first, ipv6first

--use-system-caboolean

Use as autoridades de certificação confiáveis do sistema

--use-openssl-caboolean

Use o armazenamento de CA padrão do OpenSSL

--use-bundled-caboolean

Use o armazenamento de CA empacotado

--redis-preconnectboolean

Pré-conecte a $REDIS_URL na inicialização

--sql-preconnectboolean

Pré-conecte ao PostgreSQL na inicialização

--user-agentstring

Defina o cabeçalho User-Agent padrão para solicitações HTTP

Configuração Global e Contexto

--env-filestring

Carregue variáveis de ambiente do(s) arquivo(s) especificado(s)

--cwdstring

Caminho absoluto para resolver arquivos e pontos de entrada. Isso apenas muda o cwd do processo

--configstring

Especifique o caminho para o arquivo de configuração do Bun. Padrão $cwd/bunfig.toml. Apelido: -c

Exemplos

Execute um arquivo JavaScript ou TypeScript:

bun run ./index.js
bun run ./index.tsx

Execute um script do package.json:

bun run dev
bun run lint