Bun Runtime

Bun は高速なオールインワン JavaScript ランタイムおよびツールキットです: ランタイム、パッケージマネージャー、バンドラー、テストランナーを備えています。

使用時期

• Bun を選ぶ: 新規の JS/TS プロジェクト、インストール/実行速度が重要なスクリプト、Bun ランタイムを使用する Vercel デプロイ、単一のツールチェーン (実行 + インストール + テスト + ビルド) を望む場合。
• Node を選ぶ: 最大限のエコシステム互換性が必要な場合、Node を前提とするレガシーツール、または依存関係に既知の Bun 関連の問題がある場合。

使用場面: Bun を採用する場合、Node から移行する場合、Bun スクリプト/テストを書いたりデバッグしたりする場合、または Vercel やその他のプラットフォームで Bun を設定する場合。

仕組み

• ランタイム: Node 互換のドロップイン ランタイム (JavaScriptCore を基盤とし、Zig で実装)。
• パッケージマネージャー: bun install は npm/yarn よりも大幅に高速です。ロックファイルはデフォルトで bun.lock (テキスト形式) ですが、古いバージョンの Bun では bun.lockb (バイナリ形式) を使用していました。
• バンドラー: アプリとライブラリ向けの組み込みバンドラーおよびトランスパイラー。
• テストランナー: Jest 互換の API を備えた組み込みの bun test。

Node からの移行: node script.js を bun run script.js または bun script.js に置き換えてください。npm install の代わりに bun install を実行します。ほとんどのパッケージが動作します。npm スクリプトには bun run を使用し、npx 形式の 1 回限りの実行には bun x を使用してください。Node の組み込みはサポートされています。パフォーマンスを向上させるため、存在する Bun API を優先してください。

Vercel: プロジェクト設定でランタイムを Bun に設定します。ビルド: bun run build または bun build ./src/index.ts --outdir=dist。インストール: 再現可能なデプロイのために bun install --frozen-lockfile を使用します。

例

実行とインストール

# 依存関係をインストール (bun.lock または bun.lockb を作成/更新)
bun install

# スクリプトまたはファイルを実行
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 とエコシステムは急速に進化しています。