Utilizzo CLI di bun run

bun run <file o script>

Opzioni di Esecuzione Generali

--silentboolean

Non stampare il comando dello script

--if-presentboolean

Esci senza errore se il punto di ingresso non esiste

--evalstring

Valuta l'argomento come uno script. Alias: -e

--printstring

Valuta l'argomento come uno script e stampa il risultato. Alias: -p

--helpboolean

Visualizza questo menu ed esci. Alias: -h

Gestione Workspace

--elide-linesnumber default: 10

Numero di righe di output dello script mostrate quando si usa --filter (default: 10). Imposta a 0 per mostrare tutte le righe

--filterstring

Esegui uno script in tutti i pacchetti workspace che corrispondono al pattern. Alias: -F

--workspacesboolean

Esegui uno script in tutti i pacchetti workspace (dal campo workspaces in package.json)

Runtime e Controllo Processo

--bunboolean

Forza uno script o un pacchetto a usare il runtime di Bun invece di Node.js (tramite symlinking node). Alias: -b

--shellstring

Controlla la shell usata per gli script di package.json. Supporta bun o system

--smolboolean

Usa meno memoria, ma esegui la garbage collection piu spesso

--expose-gcboolean

Espone gc() sull'oggetto globale. Non ha effetto su Bun.gc()

--no-deprecationboolean

Sopprimi tutto il reporting della deprecazione personalizzata

--throw-deprecationboolean

Determina se gli avvisi di deprecazione risultano in errori

--titlestring

Imposta il titolo del processo

--zero-fill-buffersboolean

Booleano per forzare Buffer.allocUnsafe(size) a essere riempito con zeri

--no-addonsboolean

Lancia un errore se process.dlopen viene chiamato, e disabilita la condizione di export node-addons

--unhandled-rejectionsstring

Uno tra strict, throw, warn, none, o{" "} warn-with-error-code

--console-depthnumber default: 2

Imposta la profondita predefinita per l'ispezione degli oggetti di console.log (default: 2)

Workflow di Sviluppo

--watchboolean

Riavvia automaticamente il processo al cambiamento del file

--hotboolean

Abilita il ricaricamento automatico nel runtime Bun, nel test runner o nel bundler

--no-clear-screenboolean

Disabilita la cancellazione della schermata del terminale al ricaricamento quando --hot o --watch e abilitato

Debugging

--inspectstring

Attiva il debugger di Bun

--inspect-waitstring

Attiva il debugger di Bun, aspetta una connessione prima di eseguire

--inspect-brkstring

Attiva il debugger di Bun, imposta un breakpoint sulla prima riga di codice e aspetta

Dipendenza e Risoluzione Moduli

--preloadstring

Importa un modulo prima che altri moduli siano caricati. Alias: -r

--requirestring

Alias di --preload, per compatibilita con Node.js

--importstring

Alias di --preload, per compatibilita con Node.js

--no-installboolean

Disabilita l'auto install nel runtime Bun

--installstring default: auto

Configura il comportamento dell'auto-install. Uno tra auto (default, auto-installa quando non c'e node_modules),{" "} fallback (solo pacchetti mancanti), force (sempre)

-iboolean

Auto-installa le dipendenze durante l'esecuzione. Equivalente a --install=fallback

--prefer-offlineboolean

Salta i controlli di obsolescenza per i pacchetti nel runtime Bun e risolvi da disco

--prefer-latestboolean

Usa le versioni piu recenti dei pacchetti nel runtime Bun, controllando sempre npm

--conditionsstring

Passa condizioni personalizzate alla risoluzione

--main-fieldsstring

Campi principali da cercare in package.json. Default dipende da --target

--preserve-symlinksboolean

Preserva i symlink quando si risolvono i file

--preserve-symlinks-mainboolean

Preserva i symlink quando si risolve il punto di ingresso principale

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

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

Transpilazione e Funzionalita del Linguaggio

--tsconfig-overridestring

Specifica un tsconfig.json personalizzato. Default $cwd/tsconfig.json

--definestring

Sostituisci K:V durante il parsing, es. --define process.env.NODE_ENV:"development". I valori sono parsati come JSON. Alias: -d

--dropstring

Rimuovi chiamate di funzione, es. --drop=console rimuove tutte le chiamate console.*

--loaderstring

Parsa file con .ext:loader, es. --loader .js:jsx. Loader validi: js,{" "} jsx, ts, tsx, json, toml, text,{" "} file, wasm, napi. Alias: -l

--no-macrosboolean

Disabilita le macro dall'essere eseguite nel bundler, transpiler e runtime

--jsx-factorystring

Cambia la funzione chiamata quando si compilano elementi JSX usando il runtime JSX classico

--jsx-fragmentstring

Cambia la funzione chiamata quando si compilano frammenti JSX

--jsx-import-sourcestring default: react

Dichiara il specificatore del modulo da usare per importare le funzioni factory jsx e jsxs. Default: react

--jsx-runtimestring default: automatic

automatic (default) o classic

--jsx-side-effectsboolean

Tratta gli elementi JSX come aventi effetti collaterali (disabilita le annotazioni pure)

--ignore-dce-annotationsboolean

Ignora le annotazioni di tree-shaking come @__PURE__

Rete e Sicurezza

--portnumber

Imposta la porta predefinita per Bun.serve

--fetch-preconnectstring

Preconnettiti a un URL mentre il codice sta caricando

number default: 16384

Imposta la dimensione massima delle intestazioni HTTP in byte. Default e 16KiB

--dns-result-orderstring default: verbatim

Imposta l'ordine predefinito dei risultati DNS. Ordini validi: verbatim (default), ipv4first,{" "} ipv6first

--use-system-caboolean

Usa le autorita di certificazione attendibili del sistema

--use-openssl-caboolean

Usa il store CA predefinito di OpenSSL

--use-bundled-caboolean

Usa lo store CA incluso

--redis-preconnectboolean

Preconnettiti a $REDIS_URL all'avvio

--sql-preconnectboolean

Preconnettiti a PostgreSQL all'avvio

--user-agentstring

Imposta l'intestazione User-Agent predefinita per le richieste HTTP

Configurazione Globale e Contesto

--env-filestring

Carica le variabili di ambiente dai file specificati

--cwdstring

Percorso assoluto da cui risolvere file e punti di ingresso. Questo cambia solo il cwd del processo

--configstring

Specifica il percorso al file di configurazione Bun. Default $cwd/bunfig.toml. Alias: -c

Esempi

Esegui un file JavaScript o TypeScript:

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

Esegui uno script di package.json:

bun run dev
bun run lint