Uso de CLI bun run

bun run <file or script>

Opciones Generales de Ejecución

--silentboolean

No imprime el comando del script

--if-presentboolean

Sale sin error si el punto de entrada no existe

--evalstring

Evalúa el argumento como un script. Alias: -e

--printstring

Evalúa el argumento como un script e imprime el resultado. Alias: -p

--helpboolean

Muestra este menú y sale. Alias: -h

Gestión de Workspace

--elide-linesnumber default: 10

Número de líneas de salida del script mostradas al usar --filter (predeterminado: 10). Establece a 0 para mostrar todas las líneas

--filterstring

Ejecuta un script en todos los paquetes workspace que coincidan con el patrón. Alias: -F

--workspacesboolean

Ejecuta un script en todos los paquetes workspace (desde el campo workspaces en package.json)

Control de Tiempo de Ejecución y Proceso

--bunboolean

Fuerza que un script o paquete use el runtime de Bun en lugar de Node.js (mediante enlace simbólico de node). Alias: -b

--shellstring

Controla el shell usado para scripts de package.json. Soporta bun o system

--smolboolean

Usa menos memoria, pero ejecuta garbage collection más frecuentemente

--expose-gcboolean

Expone gc() en el objeto global. No tiene efecto en Bun.gc()

--no-deprecationboolean

Suprime todo el reporte de la deprecación personalizada

--throw-deprecationboolean

Determina si las advertencias de deprecación resultan en errores

--titlestring

Establece el título del proceso

--zero-fill-buffersboolean

Booleano para forzar que Buffer.allocUnsafe(size) sea llenado con ceros

--no-addonsboolean

Lanza un error si se llama a process.dlopen, y deshabilita la condición de exportación node-addons

--unhandled-rejectionsstring

Uno de strict, throw, warn, none, o warn-with-error-code

--console-depthnumber default: 2

Establece la profundidad predeterminada para la inspección de objetos de console.log (predeterminado: 2)

Flujo de Trabajo de Desarrollo

--watchboolean

Reinicia automáticamente el proceso cuando los archivos cambian

--hotboolean

Habilita la recarga automática en el runtime de Bun, test runner, o bundler

--no-clear-screenboolean

Deshabilita limpiar la pantalla de la terminal al recargar cuando --hot o --watch está habilitado

Depuración

--inspectstring

Activa el depurador de Bun

--inspect-waitstring

Activa el depurador de Bun, espera una conexión antes de ejecutar

--inspect-brkstring

Activa el depurador de Bun, establece punto de ruptura en la primera línea de código y espera

Resolución de Dependencias y Módulos

--preloadstring

Importa un módulo antes de que otros módulos sean cargados. Alias: -r

--requirestring

Alias de --preload, para compatibilidad con Node.js

--importstring

Alias de --preload, para compatibilidad con Node.js

--no-installboolean

Deshabilita la instalación automática en el runtime de Bun

--installstring default: auto

Configura el comportamiento de instalación automática. Uno de auto (predeterminado, instala automáticamente cuando no hay node_modules), fallback (solo paquetes faltantes), force (siempre)

-iboolean

Instala automáticamente las dependencias durante la ejecución. Equivalente a --install=fallback

--prefer-offlineboolean

Omite las comprobaciones de obsolescencia para paquetes en el runtime de Bun y resuelve desde el disco

--prefer-latestboolean

Usa las últimas versiones coincidentes de paquetes en el runtime de Bun, siempre verificando npm

--conditionsstring

Pasa condiciones personalizadas para resolver

--main-fieldsstring

Campos principales para buscar en package.json. Predeterminado dependiente de --target

--preserve-symlinksboolean

Preserva enlaces simbólicos al resolver archivos

--preserve-symlinks-mainboolean

Preserva enlaces simbólicos al resolver el punto de entrada principal

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

Predeterminado: .tsx,.ts,.jsx,.js,.json

Transpilación y Características del Lenguaje

--tsconfig-overridestring

Especifica tsconfig.json personalizado. Predeterminado $cwd/tsconfig.json

--definestring

Sustituye K:V al analizar, ej. --define process.env.NODE_ENV:"development". Los valores se analizan como JSON. Alias: -d

--dropstring

Elimina llamadas a funciones, ej. --drop=console elimina todas las llamadas console.*

--loaderstring

Analiza archivos con .ext:loader, ej. --loader .js:jsx. Loaders válidos: js, jsx, ts, tsx, json, toml, text, file, wasm, napi. Alias: -l

--no-macrosboolean

Deshabilita que los macros sean ejecutados en el bundler, transpilador y runtime

--jsx-factorystring

Cambia la función llamada al compilar elementos JSX usando el runtime JSX clásico

--jsx-fragmentstring

Cambia la función llamada al compilar fragmentos JSX

--jsx-import-sourcestring default: react

Declara el especificador del módulo a usar para importar las funciones de fábrica jsx y jsxs. Predeterminado: react

--jsx-runtimestring default: automatic

automatic (predeterminado) o classic

--jsx-side-effectsboolean

Trata los elementos JSX como si tuvieran efectos secundarios (deshabilita anotaciones pure)

--ignore-dce-annotationsboolean

Ignora las anotaciones de tree-shaking como @__PURE__

Redes y Seguridad

--portnumber

Establece el puerto predeterminado para Bun.serve

--fetch-preconnectstring

Preconecta a una URL mientras el código se está cargando

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

Establece el tamaño máximo de encabezados HTTP en bytes. El predeterminado es 16KiB

--dns-result-orderstring default: verbatim

Establece el orden predeterminado de resultados de DNS. Órdenes válidas: verbatim (predeterminado), ipv4first, ipv6first

--use-system-caboolean

Usa las autoridades de certificación confiables del sistema

--use-openssl-caboolean

Usa el almacén de CA predeterminado de OpenSSL

--use-bundled-caboolean

Usa el almacén de CA incluido

--redis-preconnectboolean

Preconecta a $REDIS_URL al inicio

--sql-preconnectboolean

Preconecta a PostgreSQL al inicio

--user-agentstring

Establece el encabezado User-Agent predeterminado para solicitudes HTTP

Configuración Global y Contexto

--env-filestring

Carga variables de entorno desde el/los archivo(s) especificado(s)

--cwdstring

Ruta absoluta para resolver archivos y puntos de entrada. Esto solo cambia el cwd del proceso

--configstring

Especifica la ruta al archivo de configuración de Bun. Predeterminado $cwd/bunfig.toml. Alias: -c

Ejemplos

Ejecuta un archivo JavaScript o TypeScript:

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

Ejecuta un script de package.json:

bun run dev
bun run lint