Bun 1.4
要約
JavaScript/TypeScript開発ツールであるBunのバージョン1.4がリリースされました。このバージョンでは、Node.jsテストスイートから1,517件のテストを追加し、Node.js互換性を大幅に向上させました。また、2,900件以上のバグ修正、CPU使用率の5倍削減、メモリ使用量の最大35%削減、Linuxでの起動速度50%向上を実現しています。さらに、Bun.Image、Bun.WebView、Bun.markdown、Bun.cron()などの新APIの追加や、Bunの内部実装言語をZigからRustへ移行したことも特徴です。
全文翻訳
Bun 1.4
Bunは、フルスタックJavaScriptおよびTypeScriptアプリケーションの構築とテストのための統合ツールキットです。Bunを初めて使用する場合は、Bun 1.0のブログ記事で詳細をご確認ください。
curl
Bun 1.4では、Node.jsテストスイートから1,517以上のテストが追加され、Bun 1.0以降でNode.js互換性が最も大きく向上しました。Bun v1.4は2,900以上の問題を修正し、アイドル時のCPU使用率を5分の1に、メモリ使用量を最大35%削減し、Linuxでの起動速度を50%向上させました。さらに、Bun.Image、Bun.WebView、Bun.markdown、Bun.cron()、Bun.Terminal、bun run --parallel、bun test --parallel、bun audit fix、bun dedupe、bun pruneが追加されました。そして、BunはZigからRustに書き直されました。
この記事では、Bun 1.3.0以降にリリースされたすべての機能について説明します(Bun v1.4の新機能にはタグが付いています)。
アップグレードするには:
Node.js互換性#
BunはNode.jsのドロップイン代替となるように設計されています。すべてのBunコミットで実行されるように、Node.jsテストスイートから1,517以上のテストを追加しました。
[画像: BunでのNode.jsテストスイートファイルの合格率チャート、v1.2.0の1,450からv1.4.0の3,743へ]
node:http、node:fs、node:cluster、node:timers、node:zlib、node:vm、node:streamはNode自身のテストの97%に合格しています。node:quicは99%、node:events、node:trace_events、node:sqliteは100%です。
Node.js v26.3.0
test suite · passing on every commit
+1,517 newly passing tests
quic
235 / 237 +235
httprewritten
403 / 415 +193
fs
349 / 358 +133
tls
191 / 224 +106
http2rewritten
261 / 280 +102
repl
82 / 109 +77
stream
254 / 262 +61
worker
116 / 157 +57
process
160 / 190 +45
net
171 / 191 +39
https
61 / 65 +39
internal
68 / 108 +35
cluster
85 / 88 +31
trace_events
30 / 30 +30
webcrypto
39 / 50 +28
crypto
123 / 135 +27
vm
98 / 101 +25
webstreams
28 / 38 +23
test_runner
28 / 81 +21
module
68 / 93 +19
diagnostics_channel
36 / 69 +19
sqlite
18 / 18 +18
child_process
105 / 116 +15
inspector
22 / 110 +14
BunのNodeのtest/parallelスイートのベンダーコピーからのモジュールごとの合格数、Bun 1.3 → 1.4。ティックは1.3のベースラインを示します。
BunはまだNode.jsと100%互換ではありません。実際には、既存のJavaScriptエコシステムの大部分はそのまま動作します。BunのNode.jsテストスイートの進捗状況はこちらで追跡できます。
Playwright v1.4.0#
PlaywrightがBunで実行できるようになりました。connectOverCDP()でブラウザを操作し、playwright testとplaywright.config.tsでテストスイートを実行し、--uiで開き、WindowsでChromiumを起動できます。
Next.js 16 v1.3.2#
bun --bun next buildがTurbopackとReact Compilerを搭載したNext.js 16.3で動作します。
vitest v1.4.0#
vitestがBun上で実行され、スレッドとフォークプールを含む--coverageもサポートします。
OpenTelemetry v1.4.0#
OpenTelemetryのhttpおよびfsインストルメンテーションがスパンをエクスポートし、shimmerとrequire-in-the-middleがバンドルされたコードをパッチします。
dd-trace v1.4.0#
dd-traceが継続的にトレースし、@datadog/pprofがプロファイルします。それらがリンクするV8 C++ APIが実装されました。
追加のNode.js互換性改善#
毎日、BunはNode.js互換性100%に近づいています。変更なしでBunで動作するパッケージが増えました:
- Nuxt:
nuxt devがHMRとNuxt DevToolsを接続します。 - testcontainersとdockerode:
container.exec()が動作します。 - https-proxy-agentとsocks-proxy-agent:
http.request()がそれらを介してトンネルします。 - crawlee:
proxy-chainを介してクロールします。 - @grpc/grpc-jsとConnectRPC: Envoyの背後にあるサーバーとAWS ALBの背後にあるクライアントが動作します。
- amqplib: RabbitMQに接続します。
- @aws-sdk/client-s3: ストリーミングアップロードが動作します。
- TypeORM:
tsconfig.jsonのデコレータ設定で起動します。 - nock:
httpおよびhttpsリクエストをインターセプトします。 - Fastify
inject()とlight-my-request: 動作します。 - happy-dom:
console.logが壊れなくなりました。 - piscina: 動作します。
Bunの新しいNode.js API:
worker_threads:resourceLimits、stdout、stderr、evalオプション。- ws:
'upgrade'および'unexpected-response'イベント。 socket.upgradeTLS({ isServer: true }): サーバーサイドSTARTTLS。node:cluster: ワーカー間でリスニングソケットを共有します。node:repl、node:trace_events、node:domain: 実装されました。
本番環境#
Bun v1.4は、メモリ使用量、CPU使用量、起動時間を改善しました。
Bun v1.4まで、Bunは2つのメモリアロケータを使用していました。JavaScriptCoreのlibpasアロケータとmimallocです。BunのJavaScriptCoreは現在mimallocを使用しており(メモリ回収の改善)、mimallocには部分ページクリア、JavaScriptがアイドル時にメモリを解放するスカベンジャースレッド、およびゼロイングの改善といった機能が追加されています。
CPU使用率#
Bun上で構築された大規模な長時間実行アプリケーションであるClaude Codeでは、本番環境のCPU使用率が2倍に低下しました。p99は24%から10%に、p50は5.8%から2.5%に低下しました。
[画像: Claude Codeの本番CPU使用率、Bun 1.4前後:p99 24%から10%、p50 5.8%から2.5%]
小さな「hello world」アプリでは、アイドル時のCPU使用率が5倍に低下しました。
[画像: hello worldサーバーのアイドルCPU使用率、Bun 1.3 vs Bun 1.4:5倍低下]
これは、ガベージコレクタタイマーがGCを要求するタイミングの最適化、JavaScriptCoreがStrongルートを訪問する方法をリンクリストからセグメント化された配列のリンクリストに変更したこと、および前述のmimallocの変更と合わせてfutex呼び出し回数の削減によって実現されました。
メモリ使用量#
BunでHTTPサーバーを使用するアプリケーションでは、メモリ使用量が13%~48%削減されるはずです。
負荷下のピークメモリ(1,000,000リクエスト、64接続;Next.jsとViteは100,000):
| Server | Bun 1.4 | Bun 1.3 | Node.js 26 | Δ vs Bun 1.3 |
|---|---|---|---|---|
| fastify | 120 MB | 233 MB | 156 MB | −48% |
| Express | 92 MB | 169 MB | 145 MB | −46% |
node:http | 81 MB | 135 MB | 107 MB | −40% |
| Elysia | 55 MB | 91 MB | n/a | −40% |
| Next.js | 285 MB | 397 MB | 342 MB | −28% |
Bun.serve | 36 MB | 45 MB | n/a | −20% |
| Vite dev server | 233 MB | 268 MB | 214 MB | −13% |
Next.jsでのサーバーサイドレンダリングは、より大きな削減を達成しています。1.3で無制限に増加した一般的なApp Routerパターン(React.cache + no-store fetchをダイナミックルートで使用)では、Bun 1.4は4,000ページで238 MBに落ち着きましたが、Nodeは410 MBでした。
[画像: 4,000件のNext.js App Router SSRページでのメモリ使用量:Bun 1.4は238 MB、Nodeは410 MB、Bun 1.3は無制限に増加]Next.js App Router SSR、4,000ページ:Bun 1.4は238 MB、Nodeは410 MBに落ち着きました。
起動#
Windowsでは、Bunの起動が2.5倍速くなりました。
hello.js on Windows | Bun 1.4 | Bun 1.3.14 | Node.js 26 |
|---|---|---|---|
| Startup time | 15.5 ms | 39.0 ms | 40.1 ms |
| Peak memory | 16.8 MB | 46.5 MB | 32.5 MB |
Linuxでは、Bunの起動が2倍速くなり、メモリ使用量は半分以下になりました。
hello.js on Linux | Bun 1.4 | Bun 1.3 | Node.js 26 |
|---|---|---|---|
| Startup time | 5.1 ms | 10.9 ms | 27.2 ms |
| Peak memory | 14.6 MB | 33.0 MB | 44.5 MB |
バイナリサイズ#
LinuxとWindowsでは、Bunのサイズが最大17%小さくなりました。
| Bun 1.4 | Bun 1.3.14 | |
|---|---|---|
| Linux x64 | 77.0 MB | 88.5 MB |
| Linux arm64 | 76.8 MB | 87.6 MB |
| Windows x64 | 84.8 MB | 93.9 MB |
| Windows arm64 | 75.1 MB | 90.2 MB |
| macOS arm64 | 61.2 MB | 60.2 MB |
| macOS x64 | 66.6 MB | 66.0 MB |
macOSのバイナリは約1MB大きくなりました。
可観測性#
すでに使用しているツールがBun 1.4でも動作します。
bun --cpu-prof:.cpuprofileを書き出します。Chrome DevToolsまたはVS Codeで開けます。bun --heap-prof: V8互換の.heapsnapshotを書き出します。Chrome DevToolsで開けます。node:inspector:Sessionは、アプリ実行中にCPUプロファイルをProfiler.startとProfiler.stopで開始・停止できます。#25939- Datadog:
dd-traceはリクエストをトレースし、@datadog/pprofはCPUを継続的にプロファイルします。#36747 - OpenTelemetry: npmの
@opentelemetry/instrumentation-httpおよび@opentelemetry/instrumentation-fsパッケージは、Bunのnode:httpおよびnode:fsで動作します。それらが依存するshimmerおよびrequire-in-the-middleパッケージは、バンドルされたコードをパッチできます。 - 非同期スタックトレース:
fs.promises、fetch()、S3、DNS、またはcryptoからのエラーは、ネイティブフレームではなく、コード内のawaitを指します。
これらのうちいくつかはBunで新しくなりました。
--cpu-prof-md
--cpu-prof-mdはCPUプロファイルをMarkdown形式で書き出すため、ターミナルからホット関数を見つけることができます。自己時間によるトップ関数、コールツリー、および呼び出し元を表示します。SSHで読み取ったり、grepしたり、バグレポートに貼り付けたり、LLMに渡したりできます。
BUN_CPU_PROFILE=1は、フラグを渡せないプロセス(フレームワークによって開始されたワーカーなど)のCPUプロファイラを有効にします。
--heap-prof-md
--heap-prof-mdはヒーププロファイルをMarkdown形式で書き出すため、ターミナルからメモリを保持しているものを特定できます。総サイズ、最も保持している型、最大のオブジェクト、およびそれらを保持しているチェーンを表示します。
bun build --metafile-md
bun build --metafile-mdはバンドル分析をMarkdownレポートとして書き出すため、バンドルがなぜ大きいのかを確認できます。最大のモジュール、各エントリーポイントがロードするもの、および各ファイルをプルしたインポートチェーンを表示します。