Utilisation CLI de bun run

bun run <fichier ou script>

Options générales d'exécution

--silentboolean

N'affiche pas la commande du script

--if-presentboolean

Quitte sans erreur si le point d'entrée n'existe pas

--evalstring

Évalue l'argument comme un script. Alias : -e

--printstring

Évalue l'argument comme un script et affiche le résultat. Alias : -p

--helpboolean

Affiche ce menu et quitte. Alias : -h

Gestion des workspaces

--elide-linesnumber default: 10

Nombre de lignes de sortie de script affichées lors de l'utilisation de --filter (par défaut : 10). Définir à 0 pour afficher toutes les lignes

--filterstring

Exécute un script dans tous les paquets workspace correspondant au motif. Alias : -F

--workspacesboolean

Exécute un script dans tous les paquets workspace (depuis le champ workspaces dans package.json)

Contrôle du runtime et des processus

--bunboolean

Force un script ou un paquet à utiliser le runtime Bun au lieu de Node.js (via un lien symbolique node). Alias : -b

--shellstring

Contrôle le shell utilisé pour les scripts package.json. Prend en charge soit bun soit system

--smolboolean

Utilise moins de mémoire, mais exécute le garbage collection plus souvent

--expose-gcboolean

Expose gc() sur l'objet global. N'a aucun effet sur Bun.gc()

--no-deprecationboolean

Supprime tout signalement de la dépréciation personnalisée

--throw-deprecationboolean

Détermine si les avertissements de dépréciation entraînent des erreurs

--titlestring

Définit le titre du processus

--zero-fill-buffersboolean

Booléen pour forcer Buffer.allocUnsafe(size) à être rempli de zéros

--no-addonsboolean

Lance une erreur si process.dlopen est appelé, et désactive la condition d'export node-addons

--unhandled-rejectionsstring

L'une des valeurs strict, throw, warn, none, ou{" "} warn-with-error-code

--console-depthnumber default: 2

Définit la profondeur par défaut pour l'inspection d'objet console.log (par défaut : 2)

Flux de travail de développement

--watchboolean

Redémarre automatiquement le processus en cas de modification de fichier

--hotboolean

Active le rechargement automatique dans le runtime Bun, le test runner, ou le bundler

--no-clear-screenboolean

Désactive l'effacement de l'écran du terminal lors du rechargement lorsque --hot ou --watch est activé

Débogage

--inspectstring

Active le débogueur de Bun

--inspect-waitstring

Active le débogueur de Bun, attend une connexion avant d'exécuter

--inspect-brkstring

Active le débogueur de Bun, définit un point d'arrêt sur la première ligne de code et attend

Résolution des dépendances et des modules

--preloadstring

Importe un module avant que d'autres modules ne soient chargés. Alias : -r

--requirestring

Alias de --preload, pour la compatibilité Node.js

--importstring

Alias de --preload, pour la compatibilité Node.js

--no-installboolean

Désactive l'installation automatique dans le runtime Bun

--installstring default: auto

Configure le comportement d'installation automatique. L'une des valeurs auto (par défaut, installe automatiquement quand il n'y a pas de node_modules),{" "} fallback (paquets manquants uniquement), force (toujours)

-iboolean

Installe automatiquement les dépendances pendant l'exécution. Équivalent à --install=fallback

--prefer-offlineboolean

Ignore les vérifications d'obsolescence pour les paquets dans le runtime Bun et résout depuis le disque

--prefer-latestboolean

Utilise les dernières versions correspondantes des paquets dans le runtime Bun, vérifie toujours npm

--conditionsstring

Passe des conditions personnalisées à resolve

--main-fieldsstring

Champs principaux à rechercher dans package.json. Par défaut dépendant de --target

--preserve-symlinksboolean

Préserve les liens symboliques lors de la résolution des fichiers

--preserve-symlinks-mainboolean

Préserve les liens symboliques lors de la résolution du point d'entrée principal

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

Par défaut : .tsx,.ts,.jsx,.js,.json

Transpilation et fonctionnalités linguistiques

--tsconfig-overridestring

Spécifie un tsconfig.json personnalisé. Par défaut $cwd/tsconfig.json

--definestring

Substitue K:V lors de l'analyse, par ex. --define process.env.NODE_ENV:"development". Les valeurs sont analysées comme JSON. Alias : -d

--dropstring

Supprime les appels de fonction, par ex. --drop=console supprime tous les appels console.*

--loaderstring

Analyse les fichiers avec .ext:loader, par ex. --loader .js:jsx. Chargeurs valides : js,{" "} jsx, ts, tsx, json, toml, text,{" "} file, wasm, napi. Alias : -l

--no-macrosboolean

Désactive l'exécution des macros dans le bundler, le transpilateur et le runtime

--jsx-factorystring

Modifie la fonction appelée lors de la compilation des éléments JSX utilisant le runtime JSX classique

--jsx-fragmentstring

Modifie la fonction appelée lors de la compilation des fragments JSX

--jsx-import-sourcestring default: react

Déclare le spécificateur de module à utiliser pour importer les fonctions factory jsx et jsxs. Par défaut : react

--jsx-runtimestring default: automatic

automatic (par défaut) ou classic

--jsx-side-effectsboolean

Traite les éléments JSX comme ayant des effets secondaires (désactive les annotations pure)

--ignore-dce-annotationsboolean

Ignore les annotations de tree-shaking telles que @__PURE__

Réseau et sécurité

--portnumber

Définit le port par défaut pour Bun.serve

--fetch-preconnectstring

Préconnecte à une URL pendant le chargement du code

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

Définit la taille maximale des en-têtes HTTP en octets. Par défaut 16 KiB

--dns-result-orderstring default: verbatim

Définit l'ordre par défaut des résultats de recherche DNS. Ordres valides : verbatim (par défaut), ipv4first,{" "} ipv6first

--use-system-caboolean

Utilise les autorités de certification de confiance du système

--use-openssl-caboolean

Utilise le magasin de CA par défaut d'OpenSSL

--use-bundled-caboolean

Utilise le magasin de CA bundle

--redis-preconnectboolean

Préconnecte à $REDIS_URL au démarrage

--sql-preconnectboolean

Préconnecte à PostgreSQL au démarrage

--user-agentstring

Définit l'en-tête User-Agent par défaut pour les requêtes HTTP

Configuration globale et contexte

--env-filestring

Charge les variables d'environnement depuis le(s) fichier(s) spécifié(s)

--cwdstring

Chemin absolu pour résoudre les fichiers et points d'entrée. Cela change simplement le cwd du processus

--configstring

Spécifie le chemin du fichier de configuration Bun. Par défaut $cwd/bunfig.toml. Alias : -c

Exemples

Exécute un fichier JavaScript ou TypeScript :

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

Exécute un script package.json :

bun run dev
bun run lint