Honoは、HTTPリクエストを受け取り、テキストやJSONなどを返すWebアプリを作るためのフレームワークです。APIを小さく作りたいときや、複数の実行環境を検討したいときに候補になります。ここではNode.jsで動かす最小例から始めます。
更新:2026年10月24日。開発者名、ルーターの説明、根拠のない速度倍率を修正しました。
Honoは何をしてくれる?
Honoの作者はYusuke Wada氏です。開発の経緯は作者自身によるCloudflareの紹介記事で確認できます。Web標準のRequest・Responseを基礎とし、Cloudflare Workers、Bun、Deno、Node.jsなどの環境に対応します。ただし、ランタイム固有の機能やデータベース接続まで無条件に共通になるわけではありません。
GET /api/items/1
URLに合う処理を選ぶ
JSONとHTTPステータス
Node.jsで始める
サポート中のNode.js LTSとnpmを用意し、次を実行します。テンプレートを聞かれたらnodejsを選択してください。導入方法は公式のNode.jsガイドに基づきます。
src/index.tsを次の内容にします。商品の例はメモリ上の固定データで、データベースへの保存は行いません。
ブラウザでhttp://localhost:3000/api/items/1を開くと、商品のJSONを確認する構成です。idに文字列を指定した場合は400、存在しない番号は404を返します。学習中に意図せず外部へ公開しないよう、待ち受け先はローカルホストに限定しています。
コードの読み方
| 記述 | 役割 |
|---|---|
app.get() | GETリクエストに対応するURLと処理を登録する。 |
c.req.param('id') | URLの可変部分を文字列として取り出す。 |
c.json() | JSONレスポンスを作る。第2引数でステータスを指定できる。 |
serve() | Node.js用アダプターを通してHTTPサーバーを起動する。 |
TypeScriptの型があっても、外部から来る値が正しいとは限りません。URLやJSONボディは実行時に検証します。検証にはHonoの機能や、Zodなどと組み合わせた仕組みを利用できます。詳しくは公式のValidationガイドを参照してください。
ルーターは「正規表現を使わない」わけではない
標準構成では、SmartRouterがRegExpRouterとTrieRouterを組み合わせて使用します。RegExpRouterは登録したルートを大きな正規表現にまとめる方式、TrieRouterは木構造を使う方式です。すべてのルートを単純に順番に照合する設計とは異なります。詳しい説明と構成は公式のRoutersにあります。
フレームワークの処理速度は、ランタイム、ルート数、ミドルウェア、データベース、通信条件で変わります。「Expressの10倍」などの倍率は、測定コードと条件なしには一般化できません。自分のAPIに近い処理で、応答時間・エラー率・リソース使用量を測って判断します。
Express・Next.jsとどう使い分ける?
| 選択肢 | 主な役割 | 検討するときの観点 |
|---|---|---|
| Hono | HTTP処理、ルーティング、ミドルウェア。 | 軽いAPI、Web標準API、対象ランタイムとの適合。 |
| Express | Node.jsのWebサーバー構築。 | 既存のコードとミドルウェア、チームの経験。 |
| Next.js | Reactの画面、ルーティング、サーバー側処理。 | 画面とサーバー処理を一体で作る必要性。 |
Next.jsの画面とHonoのAPIを組み合わせることもできます。ただし、分離すると認証・デプロイ・監視の対象が増えるため、小さいサービスで必ず分ける必要はありません。各製品の対象範囲はExpress公式とNext.js公式も確認してください。
公開前に確認したいこと
入力検証、認証・認可、秘密情報の保管、必要な範囲だけのCORS、エラー時に内部情報を返さないことを確認します。Node.jsで作ったコードをWorkersへ移す場合は、ファイルアクセスやDBドライバーなどの互換性も点検します。まずは上の3つの応答(200・400・404)を確かめ、その後に保存処理や認証を追加すると、問題を切り分けやすくなります。