🚀

なぜ、「ElysiaJS」は爆速なのか

に公開
2026/02/15

はじめに

elysia_v.webp
かわいいバージョンの ElysiaJS のロゴ

ElysiaJS は Bun エコシステムで最も使われるフレームワークで、高速で効率的で安定的なタイプシステムを誇ります。また、開発者経験(DX)が優れていて、個人的にも JS/TS ベースのウェブプロジェクトを開発する時、ElysiaJS をよく使っています。

本記事では、なぜ ElysiaJS が他のフレームワークよりも魅力的なのかに関して、性能面で説明します。

以後、ElysiaJS は Elysia と略します。

Bun

Elysia は基本的に Bun ランタイムを使うことを前提として開発されています。もちろん、Node.js や Deno などでも正常動作をしますが、Elysia の性能を最大限に引き出すには Bun ランタイムが必須で、その理由は色々ありますが、最も大事な理由は Bun.serve.routes を含めて Bun のネイティブ APIを最大限活用しているためです。

Bun.serve は高性能です。単純に "zig や C++で開発したから" といった単純な理由ではなく、Bun.serve はなぜ高性能になるのかについて具体的な理由を説明いたします。

1. uWebSockets ツリー構造ベースルーティング

uWebSockets は C++ ベースの HTTP と WebSocket ウェブサーバーライブラリです。uWebSockets は非常に高性能で、同時に安定性も高いので暗号資産取引プラットフォームでよく使われています。

Bun.serveは こういう uWebSockets のルーティング方法の ツリー構造ベースルーティングを使い、HTTP サーバーと WebSocket サーバーは uWebSockets を内部エンジンとして使います。

2. SIMD 加速ルートパラメータデコード方法適用

SIMD は Single Instruction, Multiple Data の略字として、CPU で一つのコマンドでいろんなデータを同時に処理する方法です。ほとんどのプログラムの場合、SISD(Single Instruction, Single Data) 方法を使いますが、Bun のようなランタイムやコンパイラの場合テキスト処理に強い SIMDを積極的に活用します。

Bun.serve の場合、ルートパラメータデコード時、SIMD 加速を使用して性能を向上させています。

3. JavaScriptCore の内部構造をキャッシュ

Bunは JavaScriptのエンジンとして、JavaScriptCoreを使い、エンジンの内部構造をキャッシュします。これを通して、ルーティングに関するオブジェクトにアクセスする時、発生するオーバーヘッドを減らすことができます。

JIT "Compiler"

ここで語る "Compiler" は、とある言語を他の言語に変換する伝統的な意味ではなく、定義したルータとミドルウェアをもとに、最適化されたコードを動的に生成する役割を示します。(Elysia のドキュメントでは、この混乱を避けるために二重引用符付きで表記されています)

Elysia は 0.4 バージョンから JIT "Compiler" が含まれています。

Elysia は各ルートに初回リクエストが到達したタイミングで、そのルートを効率的に処理するために最適化したコードを on-the-fly(実行中) に動的に生成します。

この過程は、最新の CPU ならほとんどの場合 0.005ms 未満で完了し、ルートごとに一回だけ発生します。また、最適化コードを保存するためのメモリ使用量も少ないです。

JIT "Compiler" は new Function(...) または eval(...) を用いて実装されました。new Function(...) や eval(...) は一般的に「セキュリティ問題を起こす可能性があるため、使用すべきではない」と言われがちです。しかし、Elysia チームはこれらを適切に利用して、安全な最適化の実行を成功しました。

そのため、JIT "Compiler" の動作過程をよく理解している Elyisa アプリ開発者は、より効果的な Elysia アプリの開発ができます。

Sucrose(Static Code Analysis: 静的コード分析)

Sucrose(Static Code Analysis) は、JIT "Compiler" と共に動作する静的コード分析モジュールです。

import { Elysia } from 'elysia'

const app = new Elysia()
  .patch('/user/:id', ({ params }) => {
	return { id: params.id }
  })

例えば、上記のコードでは PATCH /user/:id エンドポイントに対するリクエストの処理は params プロパティのみが必要されていることが分かります。

Sucrose はコードを静的分析し、body, query, headers など、他のプロパティは不要だと判断します。その結果、params プロパティのみパースするように実行ユニットへ指示することができます。

従来のフレームワークでは、利用の有無に関わらず全てのプロパティをパースするため、不要なオーバーヘッドが発生しますが、Elysia は各ルートに必要な最小限のパースだけ実行するように最適化されています。

また、一般的な静的コード分析ツールを利用するのではなく、Elysia 固有の機能をサポートするために、独自の静的コード分析ライブラリ(Sucrose)を開発しました。

終わりに

Bun + Elysia の組み合わせは非常に高性能で、開発者経験(DX)も優れています。

Bun v1.0 は 2023年にリリースされ、プロダクション環境でも使われる場合も時々見られるようになりました。現在(2026年 2月)、ほとんどのデプロイプラットフォームではランタイムのオプションとして Bun を提供しています。

しかし、個人的には Bun はまだ発展途中なので、完全に安定的だとは思いません。マイナーバージョンのアップデート時に、既存アプリにランタイムエラーが引き起こす可能性がある致命的な変更のアップデートが行われることもあるし、新機能がマイナーアップデートで追加されるケースもあります。

例えば、v.1.3.4 アップデート では standalone 実行ファイルが tsconfig や package.json を自動的に読み込まなくなる仕様変更が行われ、私が運用していたアプリのサーバーで実際に障害が発生したこともあります。

関連 GitHub Issue : https://github.com/oven-sh/bun/issues/25395 (直接議論に参加してみました!)

それにも関わらず、JS/TS エコシステムにおいて Elysia は圧倒的な性能を誇るので、私は JS/TS バックエンドフレームワークで Elysia を最も好みます。

参考

Discussion