Дом

Skill

Инструменты разработчика

bun-runtime

affaan-m/ECC

Содержит рекомендации по использованию Bun в качестве среды выполнения JavaScript, менеджера пакетов, инструмента для объединения файлов и средства запуска тестов, включая информацию о миграции с Node.js и развёртывании на Vercel.

...Расширить все

Обновлено время 1 октября 2026 г.

# javascript # typescript # bun # vercel # package manager # bundler # node js migration # test runner

Bun Runtime

Bun — это быстрая универсальная среда выполнения и набор инструментов для JavaScript: среда выполнения, менеджер пакетов, инструмент для объединения файлов и средство запуска тестов.

Когда использовать

Отдавайте предпочтение Bun для: новых проектов на JS/TS, скриптов, где важна скорость установки и запуска, развёртываний на Vercel с использованием среды выполнения Bun, а также когда вам нужен единый набор инструментов (запуск + установка + тестирование + сборка).
Предпочтите Node в следующих случаях: для максимальной совместимости с экосистемой, при использовании устаревших инструментов, рассчитанных на Node, или если у какой-либо зависимости известны проблемы с Bun.

Используйте, если: внедряете Bun, мигрируете с Node, пишете или отлаживаете скрипты/тесты для Bun, либо настраиваете Bun на Vercel или других платформах.

Как это работает

Среда выполнения: готовая к использованию среда выполнения, совместимая с Node (построена на JavaScriptCore, реализована на Zig).
Менеджер пакетов: bun install работает значительно быстрее, чем npm/yarn. По умолчанию в текущей версии Bun файл фиксации версий имеет формат bun.lock (текстовый) по умолчанию в текущей версии Bun; в более старых версиях использовался bun.lockb (бинарный).
Пакетный сборщик: встроенный сборщик и транспайлер для приложений и библиотек.
Средство запуска тестов: встроенное bun test с API, похожим на Jest.

Переход с Node: Замените node script.js на bun run script.js или bun script.js. Запустите bun install вместо npm install; большинство пакетов работают. Используйте bun run для скриптов npm; bun x для разовых запусков в стиле npx. Встроенные функции Node поддерживаются; для лучшей производительности предпочитайте API Bun, если они доступны.

Vercel: в настройках проекта установите Bun в качестве среды выполнения. Сборка: bun run build или bun build ./src/index.ts --outdir=dist. Установка: bun install --frozen-lockfile для воспроизводимых развёртываний.

Примеры

Запуск и установка

# Install dependencies (creates/updates bun.lock or bun.lockb)
bun install

# Run a script or file
bun run dev
bun run src/index.ts
bun src/index.ts

Скрипты и среда

bun run --env-file=.env dev
FOO=bar bun run script.ts

Тестирование

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";

test("add", () => {
  expect(1 + 2).toBe(3);
});

API среды выполнения

const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});

Рекомендации

Зафиксируйте файл блокировки (bun.lock или bun.lockb) для воспроизводимых установок.
Предпочтительно использовать bun run для скриптов. Для TypeScript Bun работает .ts нативно.
Обновляйте зависимости; Bun и экосистема быстро развиваются.

Посмотреть на GitHub

---
name: bun-runtime
description: Provides guidance on using Bun as a JavaScript runtime, package manager, bundler, and test runner, including migration from Node.js and Vercel deployment.
---

# Bun Runtime

Bun is a fast all-in-one JavaScript runtime and toolkit: runtime, package manager, bundler, and test runner.

## When to Use

- **Prefer Bun** for: new JS/TS projects, scripts where install/run speed matters, Vercel deployments with Bun runtime, and when you want a single toolchain (run + install + test + build).
- **Prefer Node** for: maximum ecosystem compatibility, legacy tooling that assumes Node, or when a dependency has known Bun issues.

Use when: adopting Bun, migrating from Node, writing or debugging Bun scripts/tests, or configuring Bun on Vercel or other platforms.

## How It Works

- **Runtime**: Drop-in Node-compatible runtime (built on JavaScriptCore, implemented in Zig).
- **Package manager**: `bun install` is significantly faster than npm/yarn. Lockfile is `bun.lock` (text) by default in current Bun; older versions used `bun.lockb` (binary).
- **Bundler**: Built-in bundler and transpiler for apps and libraries.
- **Test runner**: Built-in `bun test` with Jest-like API.

**Migration from Node**: Replace `node script.js` with `bun run script.js` or `bun script.js`. Run `bun install` in place of `npm install`; most packages work. Use `bun run` for npm scripts; `bun x` for npx-style one-off runs. Node built-ins are supported; prefer Bun APIs where they exist for better performance.

**Vercel**: Set runtime to Bun in project settings. Build: `bun run build` or `bun build ./src/index.ts --outdir=dist`. Install: `bun install --frozen-lockfile` for reproducible deploys.

## Examples

### Run and install

```bash
# Install dependencies (creates/updates bun.lock or bun.lockb)
bun install

# Run a script or file
bun run dev
bun run src/index.ts
bun src/index.ts
```

### Scripts and env

```bash
bun run --env-file=.env dev
FOO=bar bun run script.ts
```

### Testing

```bash
bun test
bun test --watch
```

```typescript
// test/example.test.ts
import { expect, test } from "bun:test";

test("add", () => {
  expect(1 + 2).toBe(3);
});
```

### Runtime API

```typescript
const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});
```

## Best Practices

- Commit the lockfile (`bun.lock` or `bun.lockb`) for reproducible installs.
- Prefer `bun run` for scripts. For TypeScript, Bun runs `.ts` natively.
- Keep dependencies up to date; Bun and the ecosystem evolve quickly.