Использование CLI bun run

bun run <файл или скрипт>

Общие опции выполнения

--silentboolean

Не печатать команду скрипта

--if-presentboolean

Выйти без ошибки, если точка входа не существует

--evalstring

Вычислить аргумент как скрипт. Псевдоним: -e

--printstring

Вычислить аргумент как скрипт и вывести результат. Псевдоним: -p

--helpboolean

Отобразить это меню и выйти. Псевдоним: -h

Управление рабочими областями

--elide-linesnumber default: 10

Количество строк вывода скрипта, показываемых при использовании --filter (по умолчанию: 10). Установите 0 для показа всех строк

--filterstring

Запустить скрипт во всех пакетах рабочей области, соответствующих шаблону. Псевдоним: -F

--workspacesboolean

Запустить скрипт во всех пакетах рабочей области (из поля workspaces в package.json)

Управление средой выполнения и процессом

--bunboolean

Принудительно заставить скрипт или пакет использовать среду выполнения Bun вместо Node.js (через симлинк node). Псевдоним: -b

--shellstring

Управлять оболочкой, используемой для скриптов package.json. Поддерживается либо bun, либо system

--smolboolean

Использовать меньше памяти, но чаще запускать сборку мусора

--expose-gcboolean

Предоставить gc() в глобальном объекте. Не влияет на Bun.gc()

--no-deprecationboolean

Подавить всю отчетность о пользовательских устареваниях

--throw-deprecationboolean

Определить, приводят ли предупреждения об устаревании к ошибкам

--titlestring

Установить заголовок процесса

--zero-fill-buffersboolean

Логическое значение для принудительного заполнения Buffer.allocUnsafe(size) нулями

--no-addonsboolean

Выдать ошибку, если вызван process.dlopen, и отключить условие экспорта node-addons

--unhandled-rejectionsstring

Одно из strict, throw, warn, none или warn-with-error-code

--console-depthnumber default: 2

Установить глубину по умолчанию для проверки объекта console.log (по умолчанию: 2)

Рабочий процесс разработки

--watchboolean

Автоматически перезапускать процесс при изменении файлов

--hotboolean

Включить автоматическую перезагрузку в среде выполнения Bun, тестовом раннере или бандлере

--no-clear-screenboolean

Отключить очистку экрана терминала при перезагрузке, когда включён --hot или --watch

Отладка

--inspectstring

Активировать отладчик Bun

--inspect-waitstring

Активировать отладчик Bun, ждать подключения перед выполнением

--inspect-brkstring

Активировать отладчик Bun, установить точку останова на первой строке кода и ждать

Разрешение зависимостей и модулей

--preloadstring

Импортировать модуль перед загрузкой других модулей. Псевдоним: -r

--requirestring

Псевдоним --preload для совместимости с Node.js

--importstring

Псевдоним --preload для совместимости с Node.js

--no-installboolean

Отключить автоматическую установку в среде выполнения Bun

--installstring default: auto

Настроить поведение автоматической установки. Одно из auto (по умолчанию, автоустановка при отсутствии node_modules), fallback (только отсутствующие пакеты), force (всегда)

-iboolean

Автоматически устанавливать зависимости во время выполнения. Эквивалентно --install=fallback

--prefer-offlineboolean

Пропустить проверки актуальности для пакетов в среде выполнения Bun и разрешать с диска

--prefer-latestboolean

Использовать последние подходящие версии пакетов в среде выполнения Bun, всегда проверяя npm

--conditionsstring

Передать пользовательские условия для разрешения

--main-fieldsstring

Основные поля для поиска в package.json. По умолчанию зависит от --target

--preserve-symlinksboolean

Сохранять симлинки при разрешении файлов

--preserve-symlinks-mainboolean

Сохранять симлинки при разрешении главной точки входа

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

По умолчанию: .tsx,.ts,.jsx,.js,.json

Транспиляция и языковые функции

--tsconfig-overridestring

Указать пользовательский tsconfig.json. По умолчанию $cwd/tsconfig.json

--definestring

Подставить K:V при парсинге, например --define process.env.NODE_ENV:"development". Значения парсятся как JSON. Псевдоним: -d

--dropstring

Удалить вызовы функций, например --drop=console удаляет все вызовы console.*

--loaderstring

Парсить файлы с .ext:loader, например --loader .js:jsx. Допустимые загрузчики: js, jsx, ts, tsx, json, toml, text, file, wasm, napi. Псевдоним: -l

--no-macrosboolean

Отключить выполнение макросов в бандлере, транспиляторе и среде выполнения

--jsx-factorystring

Изменить функцию, вызываемую при компиляции JSX элементов с использованием классического runtime JSX

--jsx-fragmentstring

Изменить функцию, вызываемую при компиляции JSX фрагментов

--jsx-import-sourcestring default: react

Объявляет спецификатор модуля, используемый для импорта фабричных функций jsx и jsxs. По умолчанию: react

--jsx-runtimestring default: automatic

automatic (по умолчанию) или classic

--jsx-side-effectsboolean

Считать JSX элементы имеющими побочные эффекты (отключить аннотации pure)

--ignore-dce-annotationsboolean

Игнорировать аннотации tree-shaking, такие как @__PURE__

Сеть и безопасность

--portnumber

Установить порт по умолчанию для Bun.serve

--fetch-preconnectstring

Предварительно подключиться к URL во время загрузки кода

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

Установить максимальный размер HTTP заголовков в байтах. По умолчанию 16 КиБ

--dns-result-orderstring default: verbatim

Установить порядок результатов DNS по умолчанию. Допустимые порядки: verbatim (по умолчанию), ipv4first, ipv6first

--use-system-caboolean

Использовать системные доверенные сертификаты центров сертификации

--use-openssl-caboolean

Использовать хранилище сертификатов OpenSSL по умолчанию

--use-bundled-caboolean

Использовать встроенное хранилище сертификатов

--redis-preconnectboolean

Предварительно подключиться к $REDIS_URL при запуске

--sql-preconnectboolean

Предварительно подключиться к PostgreSQL при запуске

--user-agentstring

Установить заголовок User-Agent по умолчанию для HTTP запросов

Глобальная конфигурация и контекст

--env-filestring

Загрузить переменные окружения из указанного файла (ов)

--cwdstring

Абсолютный путь для разрешения файлов и точек входа. Это просто меняет cwd процесса

--configstring

Указать путь к файлу конфигурации Bun. По умолчанию $cwd/bunfig.toml. Псевдоним: -c

Примеры

Запуск файла JavaScript или TypeScript:

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

Запуск скрипта package.json:

bun run dev
bun run lint