bun-expert

Bun ランタイム開発ガイド

このスキルは、公式の Bun ドキュメントを意図的に基盤としています。Bun は急速に進化するため、固定されたリリース予定やベンチマークの主張よりも、最新のドキュメントを優先してください。

---

最近の機能レーダー

Bun では新しい組み込み機能が次々と追加されています。この一覧では、Bun 1.3（2025 年 10 月）から Bun 1.3.14（2026 年 5 月）頃までに追加された機能を紹介します。モデルの学習データには含まれていない可能性が高い機能です。さらに新しい機能については、存在しないと決めつける前に https://bun.com/blog を確認してください。

通常ならインストールする依存関係の代わりに、次の機能を利用してください。

• Bun.SQL：Postgres、MySQL/MariaDB、SQLite の単一クライアントです。pg、mysql2、postgres は不要です。
• Bun.redis：Redis/Valkey ネイティブクライアントです。ioredis／node-redis は不要です。
• Bun.secrets：OS のキーチェーンを利用した認証情報の保存機能です。keytar は不要です。
• Bun.YAML.parse／.stringify：組み込みの YAML 機能です。js-yaml／yaml は不要です。
• CompressionStream／DecompressionStream は、gzip／deflate だけでなく、"brotli" と "zstd" 形式にも対応するようになりました。
• Bun.stripANSI、URLPattern、DisposableStack／AsyncDisposableStack は組み込みです。strip-ansi や、ユーザーランドの URL パターン／クリーンアップ用ヘルパーは不要です。
• Bun.markdown（.html／.render／.react）：CommonMark+GFM 対応の組み込みパーサーです。bun ./file.md でターミナル上に Markdown を表示できます。一般的な用途で markdown-it／marked は不要です。
• Fake timers が bun:test に追加されました（useFakeTimers、advanceTimersByTime、setSystemTime、useRealTimers）。sinon／@sinonjs/fake-timers は不要です。
• HTML エントリーポイントの開発サーバーに、import.meta.hot を使ったホットモジュールリプレースメントが追加されました。シンプルなフロントエンドであれば、別途 Vite／webpack 開発サーバーを用意する必要はありません。
• globalStore = true（または BUN_INSTALL_GLOBAL_STORE=1）を使う bun install --linker=isolated：実験段階ですが、ウォームインストールを大幅に高速化するグローバル仮想ストアです。
• まだ実験段階のため、本番環境でこれらを標準として使わないでください。Bun.WebView（Puppeteer／Playwright を使わないブラウザー自動化）と、Bun.serve({ http3: true }) および fetch({ protocol: "h3" }) による HTTP/3 over QUIC が該当します。

---

組み込み API マップ

用途	Bun API
HTTP サーバー + WebSockets	Bun.serve()
SQL データベース	sql、SQL、Bun.sql、Bun.SQL
S3 互換ストレージ	s3、S3Client
Redis	redis、RedisClient
スケジュールタスク（cron）	Bun.cron、Bun.cron.parse
画像処理	Bun.Image、Blob#image()、Bun.file().image()
ブラウザー自動化	Bun.WebView
Markdown のレンダリング	Bun.markdown.html、Bun.markdown.render、Bun.markdown.react
シェルスクリプト	Bun.$ / $
ローカルファイル	Bun.file、Bun.write
SQLite（組み込み）	bun:sqlite
パスワードのハッシュ化	Bun.password
PTY ベースのサブプロセス	Bun.Terminal、Bun.spawn({ terminal })

---

詳細リファレンス

リファレンス	内容
references/builtin-apis.md	Bun.serve、HTTP/3、WebSockets、SQL、S3、Redis、Bun.Image、Bun.WebView、Markdown、cron、シェル、PTY、ファイルシステム、暗号化 API
references/package-management.md	インストール、ロックファイル、isolated linker、グローバル仮想ストア、カタログ、ライフサイクルスクリプトのセキュリティ
references/testing-and-bundling.md	bun test の使い方、テストスイート分割フラグ、モックのパターン、bun build の CLI と API
references/node-migration.md	Node から Bun への実践的な移行手順と互換性に関するガイダンス

---

公式ドキュメント

• https://bun.com/docs
• https://bun.com/blog