bun run CLI-Verwendung

bun run <Datei oder Skript>

Allgemeine Ausführungsoptionen

--silentboolean

Skriptbefehl nicht ausgeben

--if-presentboolean

Ohne Fehler beenden, wenn der Einstiegspunkt nicht existiert

--evalstring

Argument als Skript auswerten. Alias: -e

--printstring

Argument als Skript auswerten und Ergebnis ausgeben. Alias: -p

--helpboolean

Dieses Menü anzeigen und beenden. Alias: -h

Workspace-Verwaltung

--elide-linesnumber default: 10

Anzahl der angezeigten Skriptausgabezeilen bei Verwendung von --filter (Standard: 10). Auf 0 setzen, um alle Zeilen anzuzeigen

--filterstring

Ein Skript in allen Workspace-Paketen ausführen, die dem Muster entsprechen. Alias: -F

--workspacesboolean

Ein Skript in allen Workspace-Paketen ausführen (aus dem workspaces-Feld in package.json)

Laufzeit- und Prozesssteuerung

--bunboolean

Erzwingt, dass ein Skript oder Paket Buns Laufzeit statt Node.js verwendet (durch Symlinking von node). Alias: -b

--shellstring

Steuert die für package.json-Skripte verwendete Shell. Unterstützt entweder bun oder system

--smolboolean

Verwendet weniger Speicher, führt aber häufiger Garbage Collection durch

--expose-gcboolean

Macht gc() im globalen Objekt verfügbar. Hat keine Auswirkung auf Bun.gc()

--no-deprecationboolean

Unterdrückt alle Berichte über benutzerdefinierte Deprecation-Warnungen

--throw-deprecationboolean

Bestimmt, ob Deprecation-Warnungen zu Fehlern führen

--titlestring

Setzt den Prozesstitel

--zero-fill-buffersboolean

Boolean, um Buffer.allocUnsafe(size) mit Nullen zu füllen

--no-addonsboolean

Wirft einen Fehler, wenn process.dlopen aufgerufen wird, und deaktiviert die Exportbedingung node-addons

--unhandled-rejectionsstring

Einer von strict, throw, warn, none oder{" "} warn-with-error-code

--console-depthnumber default: 2

Setzt die Standardtiefe für die Objektinspektion von console.log (Standard: 2)

Entwicklungs-Workflow

--watchboolean

Startet den Prozess bei Dateiänderungen automatisch neu

--hotboolean

Aktiviert automatisches Neuladen im Bun-Laufzeit, Test-Runner oder Bundler

--no-clear-screenboolean

Deaktiviert das Leeren des Terminalbildschirms beim Neuladen, wenn --hot oder --watch aktiviert ist

Debugging

--inspectstring

Aktiviert Buns Debugger

--inspect-waitstring

Aktiviert Buns Debugger, wartet auf eine Verbindung vor der Ausführung

--inspect-brkstring

Aktiviert Buns Debugger, setzt Breakpoint in der ersten Codezeile und wartet

Abhängigkeits- und Modulauflösung

--preloadstring

Importiert ein Modul, bevor andere Module geladen werden. Alias: -r

--requirestring

Alias von --preload, für Node.js-Kompatibilität

--importstring

Alias von --preload, für Node.js-Kompatibilität

--no-installboolean

Deaktiviert die automatische Installation im Bun-Laufzeit

--installstring default: auto

Konfiguriert das automatische Installationsverhalten. Einer von auto (Standard, installiert automatisch wenn kein node_modules),{" "} fallback (nur fehlende Pakete), force (immer)

-iboolean

Abhängigkeiten während der Ausführung automatisch installieren. Entspricht --install=fallback

--prefer-offlineboolean

Überspringt Staleness-Prüfungen für Pakete im Bun-Laufzeit und löst von der Festplatte auf

--prefer-latestboolean

Verwendet die neuesten passenden Versionen von Paketen im Bun-Laufzeit und prüft immer npm

--conditionsstring

Übergibt benutzerdefinierte Bedingungen an resolve

--main-fieldsstring

Hauptfelder, die in package.json nachgeschlagen werden. Standard ist --target-abhängig

--preserve-symlinksboolean

Behält Symlinks beim Auflösen von Dateien bei

--preserve-symlinks-mainboolean

Behält Symlinks beim Auflösen des Haupteinstiegspunkts bei

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

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

Transpilierung und Sprachfunktionen

--tsconfig-overridestring

Benutzerdefinierte tsconfig.json angeben. Standard $cwd/tsconfig.json

--definestring

Ersetzt K:V beim Parsen, z.B. --define process.env.NODE_ENV:"development". Werte werden als JSON geparst. Alias: -d

--dropstring

Entfernt Funktionsaufrufe, z.B. entfernt --drop=console alle console.*-Aufrufe

--loaderstring

Parst Dateien mit .ext:loader, z.B. --loader .js:jsx. Gültige Loader: js,{" "} jsx, ts, tsx, json, toml, text,{" "} file, wasm, napi. Alias: -l

--no-macrosboolean

Deaktiviert die Ausführung von Makros im Bundler, Transpiler und Laufzeit

--jsx-factorystring

Ändert die Funktion, die beim Kompilieren von JSX-Elementen mit der klassischen JSX-Laufzeit aufgerufen wird

--jsx-fragmentstring

Ändert die Funktion, die beim Kompilieren von JSX-Fragmenten aufgerufen wird

--jsx-import-sourcestring default: react

Deklariert den Modulspezifizierer für den Import der jsx- und jsxs-Factory-Funktionen. Standard: react

--jsx-runtimestring default: automatic

automatic (Standard) oder classic

--jsx-side-effectsboolean

Behandelt JSX-Elemente als nebenwirkungsbehaftet (deaktiviert Pure-Annotationen)

--ignore-dce-annotationsboolean

Ignoriert Tree-Shaking-Annotationen wie @__PURE__

Netzwerk und Sicherheit

--portnumber

Setzt den Standardport für Bun.serve

--fetch-preconnectstring

Stellt während des Ladens des Codes eine Vorverbindung zu einer URL her

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

Setzt die maximale Größe von HTTP-Headern in Bytes. Standard ist 16 KiB

--dns-result-orderstring default: verbatim

Setzt die Standardreihenfolge der DNS-Lookup-Ergebnisse. Gültige Reihenfolgen: verbatim (Standard), ipv4first,{" "} ipv6first

--use-system-caboolean

Verwendet die vertrauenswürdigen Zertifikatsstellen des Systems

--use-openssl-caboolean

Verwendet OpenSSLs Standard-CA-Speicher

--use-bundled-caboolean

Verwendet den gebündelten CA-Speicher

--redis-preconnectboolean

Stellt beim Start eine Vorverbindung zu $REDIS_URL her

--sql-preconnectboolean

Stellt beim Start eine Vorverbindung zu PostgreSQL her

--user-agentstring

Setzt den Standard-User-Agent-Header für HTTP-Anfragen

Globale Konfiguration und Kontext

--env-filestring

Lädt Umgebungsvariablen aus der angegebenen(n) Datei(en)

--cwdstring

Absoluter Pfad, von dem Dateien und Einstiegspunkte aufgelöst werden. Ändert nur das cwd des Prozesses

--configstring

Pfad zur Bun-Konfigurationsdatei angeben. Standard $cwd/bunfig.toml. Alias: -c

Beispiele

Führt eine JavaScript- oder TypeScript-Datei aus:

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

Führt ein package.json-Skript aus:

bun run dev
bun run lint