ブログ一覧に戻る

Bun 1.4 の組み込み API は npm パッケージをどこまで置き換えられるか:Linux で6つを実測

Bun 1.4 は標準で多くの API を内蔵し、「15個ほどの npm 依存が不要になる」と紹介する動画(Bun 1.4 Just Deleted 15 of Your Dependencies、Better Stack)があります。この記事では、その言い分のうち Linux 上で自分が動かして確かめられた範囲 だけを書きます。対象は Next.js や Node.js のスクリプトで marked・sharp・node-cron・Playwright などを使っていて、Bun への置き換えを検討している人です。

TL;DR

  • Bun.markdown.html() は 27万字の入力で marked の約19倍速かった(5回平均、ただし marked も Bun 上で実行)。ただし出力の HTML は細部が違い、<script> や javascript: リンクはサニタイズされずそのまま出る。
  • Bun.Image は sharp と同程度(この条件では約1.1倍)。HEIC / AVIF は Linux では使えない。ぼかし・合成などは API 自体が無い。
  • Bun.cron は5フィールドのみ。node-cron が受け付ける秒つき6フィールドは ERR_INVALID_ARG_TYPE で拒否された。
  • Bun.WebView は Linux では別途 Chrome 系ブラウザが必要。root では --no-sandbox を渡さないと起動に失敗した。
  • まとめ記事などで見かける名前と実際の API 名が違うことがある(例: 実機では Bun.Markdown ではなく Bun.markdown、文字幅や切り詰めは Bun.stringWidth / Bun.sliceAnsi / Bun.wrapAnsi)。記憶やまとめ記事の名前をそのままコードに書くと動かない。

背景:なぜ今これを確かめるのか

bun の npm パッケージのタイムスタンプでは、1.4.0 は 2026-08-20、最新の 1.4.2 は 2026-09-05 に公開されています(npm レジストリで確認、2026年10月3日時点)。同梱ドキュメントには Markdown パーサーが Rust 製と書かれているなど、実装面でも大きな更新でした(実装言語全体の書き換えについては、一次資料で確認できていないため扱いません)。

一方で「標準ライブラリが増えた=既存の依存を消せる」は、機能が同じでなければ成り立ちません。依存を消す前に、出力・性能・対応プラットフォームが自分の用途に足りるかを見る必要があります。

なお、公式ブログ(bun.com)はこの実行環境のネットワークから読めませんでした。そのため仕様の根拠は、@types/bun@1.4.2 に同梱されている公式ドキュメント(bun-types/docs)と、実際に動かした結果です。リリースノートに書かれた数値(起動速度・メモリなど)は確認していません。

検証環境

項目内容
実行日2026年10月3日
OSLinux x86_64(クラウドのサンドボックス、4 vCPU、root で実行)
Bun1.4.2(npm i bun@1.4.2、bun --revision は 1.4.2+744846f84)
比較対象marked 18.0.14、sharp 0.35.5、node-cron 4.6.0、string-width 8.3.0
ブラウザPlaywright 同梱の headless_shell(Chromium 系)

計測はすべて同一プロセス内で、各5回を取りました。サンドボックスは共有環境のため、絶対値より相対比を見てください。

実装と結果

1. Markdown:速いが、marked の置き換えではなく「別物」

API 名は Bun.markdown(小文字)です。Bun.Markdown は undefined でした。

import { marked } from "marked";

const a = Bun.markdown.html(src);
const b = await marked.parse(src);

9種類の小さな文書(見出し・リスト・表・タスクリスト・取り消し線・コードブロック・生 HTML など)で出力を比べると、4種が完全一致、残りは細部が違いました。

入力違い
表Bun は <tr> を1行にまとめ、marked は各セルを改行する
タスクリストBun は class="task-list-item" と task-list-item-checkbox を付ける
URL の自動リンク既定では Bun はリンクにしない(autolinks: true で有効)
入れ子リスト子リストの手前の改行の有無が違う

見た目の差は小さくても、スナップショットテストや CSS が前提にしている HTML の形は変わります。置き換えるなら出力の比較テストを先に作ってください。

次は速度です。2,000セクション(272,669文字)の文書を html() に渡し、5回繰り返して1回あたりの平均を取りました。

平均(5回)範囲
Bun.markdown.html4.9 ms4.3〜5.9 ms
marked.parse(Bun 上で実行)95.5 ms82.4〜106.5 ms

約19倍です。ただし marked も Bun のランタイム上で動かしており、Node.js 上の値ではありません。

ハマりどころはサニタイズです。 <script>alert(1)</script> と [x](javascript:alert(1)) を渡すと、既定ではどちらもそのまま出力されました。tagFilter: true を付けると <script> は &lt;script> になりましたが、javascript: のリンクは残りました。ユーザー入力を描画する用途では、別途サニタイザが必要です(これは marked も同様です)。

2. Image:sharp と同程度、ただし機能は狭い

4000×3000 の合成 JPEG(4.5MB)を 800×600 以内の WebP(quality 80)に変換しました。

const out = await new Bun.Image(jpg).resize(800, 600, { fit: "inside" }).webp({ quality: 80 }).bytes();
平均(5回)出力サイズ
Bun.Image97.8 ms6,168 B
sharp107.0 ms6,214 B

約1.1倍で、20並列の1回測定でも Bun が513ms、sharp が631msと同じ傾向でした。この入力は乱数ノイズを含む合成画像なので、実際の写真では差が変わる可能性があります。

機能面では、公式ドキュメントと実機で次を確認しました。

  • メソッドは resize / rotate / flip / flop / modulate / 出力形式 / placeholder など。ぼかし、シャープ、合成、切り抜きは見当たりません。
  • avif() は Linux では ERR_IMAGE_FORMAT_UNSUPPORTED で拒否されました。HEIC / AVIF は macOS / Windows の OS コーデック頼みです。
  • placeholder() はドキュメントでは「約400〜700バイト」とありますが、このノイズ画像では base64 で1,674文字(約1.2KB)でした。画像の内容に依存すると思われますが、未検証です。

サムネイル生成だけなら置き換え候補になります。Sharp の広い画像編集を使っているなら、そのまま残すのが現実的です。

3. cron:5フィールドだけ

Bun.cron.parse は日本時間の指定で期待どおりに動きました。

Bun.cron.parse("30 9 * * MON-FRI", new Date("2026-10-03T00:00:00Z"), { tz: "Asia/Tokyo" });
// 2026-10-05T00:30:00.000Z(月曜 9:30 JST)

存在しない日付(0 0 30 2 *)は null を返しました。プロセス内でコールバックを動かす Bun.cron("* * * * *", fn) も、65秒の待機中に1回発火しました。

一方、node-cron が通した秒つき6フィールド "* * * * * *" は、Bun では次のエラーで拒否されます。

TypeError: Invalid cron expression: too many fields. Bun.cron uses 5 fields (minute hour day month weekday) — seconds are not supported

秒単位のジョブがあるなら、node-cron の置き換えはできません。

4. WebView:Linux では「依存なし」にならない

macOS では OS の WebKit を使いますが、Linux では Chrome 系ブラウザを別に用意する必要があります(公式ドキュメントの記載どおりです)。今回の環境では次の結果でした。

起動の仕方結果
パス指定なし(自動検出)Failed to spawn Chrome
path 指定のみ(root)Chrome process closed the pipe
path + argv: ["--no-sandbox"]成功
const view = new Bun.WebView({
  width: 800, height: 600,
  backend: { type: "chrome", path: "/path/to/headless_shell", argv: ["--no-sandbox"] },
});
await view.navigate("data:text/html,<ul><li>a</li><li>b</li></ul>");
await view.evaluate("[...document.querySelectorAll('li')].map(li => li.textContent)"); // ["a","b"]

成功後は evaluate とクリック、スクリーンショットの取得まで動きました。最初の1回は約770ms(ブラウザ起動を含む)、2回目以降は45〜65msでした。root で --no-sandbox を付けるのはコンテナ向けの回避策であり、信頼できないページを開く用途には勧められません。Playwright のトレースビューアやテストランナーに当たるものは、Bun.WebView には見当たりませんでした。

5. Terminal と run --parallel

Bun.spawn に terminal を渡すと、子プロセスから見て [ -t 1 ] が真になりました(渡さない場合は偽)。node-pty が担っていた「端末として振る舞わせる」用途は動いています。端末エミュレータ上でのキー入力など、対話的な用途は今回は試していません。

bun run --parallel a b は2つの1秒スクリプトを約1秒で終え、a | A done のようにスクリプト名の接頭辞を付けて出力しました。ワイルドカード('w:*')も動作します。1つが exit 3 で失敗すると全体の終了コードは3になりました。concurrently との速度比較は行っていません。

考察:置き換えてよいかの判断表

用途判断理由
Markdown → HTML(信頼できる自前の文書)置き換え候補約19倍速。ただし HTML 差分のテストが要る
Markdown(ユーザー入力)サニタイザは別途必須<script> と javascript: が残る
サムネイル生成置き換え候補同程度の速度で依存が減る
画像のぼかし・合成・HEIC / AVIF置き換え不可API が無い、または Linux 非対応
分単位の定期実行置き換え候補5フィールド、tz 指定可
秒単位の定期実行置き換え不可秒フィールドを拒否
ブラウザ自動化条件つきLinux ではブラウザを別途用意。テスト基盤は無い

「15個の依存が消える」は、この検証では確認できていません。私が動かして確かめたのは上の表の6つの API に加え、Bun.Archive の tar.gz の書き出しと読み戻し、Bun.stringWidth と string-width の5入力での一致です。置き換えの可否は用途で分かれました。

まとめ

Bun 1.4.2 の組み込み API は、Linux 上で実際に動き、いくつかは速度面でも実用的でした。ただし出力の細部、サニタイズの有無、秒つき cron や HEIC などの対応範囲、WebView のブラウザ依存は、依存を消す前に自分のコードで確かめる必要があります。動かしたコードは小さいので、手元の入力で同じ比較をそのまま再現できます。

参考資料

この記事は、AI エージェントによる調査・検証・下書きをもとに、筆者が内容を確認して公開しています。