Honoとは?Node.jsでAPIを作る入門とルーターの仕組み

公開 更新 約5分で読む著者:admin

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
Hono
URLに合う処理を選ぶ
処理結果
JSONとHTTPステータス
図1:左から右へ処理し、生成したレスポンスをクライアントへ返す。Honoはデータベースそのものではありません。

Node.jsで始める

サポート中のNode.js LTSとnpmを用意し、次を実行します。テンプレートを聞かれたらnodejsを選択してください。導入方法は公式のNode.jsガイドに基づきます。

BASH
npm create hono@latest hono-start
cd hono-start
npm install

src/index.tsを次の内容にします。商品の例はメモリ上の固定データで、データベースへの保存は行いません。

TYPESCRIPT
import { Hono } from 'hono'
import { serve } from '@hono/node-server'

const app = new Hono()
const items = new Map([[1, { id: 1, name: 'ノート' }]])

app.get('/', (c) => c.text('HonoのAPIです'))

app.get('/api/items/:id', (c) => {
  const raw = c.req.param('id')
  if (!/^[1-9]\d*$/.test(raw)) {
    return c.json({ error: 'IDは正の整数にしてください' }, 400)
  }
  const id = Number(raw)
  if (!Number.isSafeInteger(id)) {
    return c.json({ error: 'IDの範囲が不正です' }, 400)
  }
  const item = items.get(id)
  if (!item) return c.json({ error: '商品が見つかりません' }, 404)
  return c.json(item)
})

app.notFound((c) => c.json({ error: 'ページが見つかりません' }, 404))

serve({ fetch: app.fetch, hostname: '127.0.0.1', port: 3000 })
BASH
npm run dev

ブラウザで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とどう使い分ける?

優劣ではなく、担当する範囲から比較
選択肢主な役割検討するときの観点
HonoHTTP処理、ルーティング、ミドルウェア。軽いAPI、Web標準API、対象ランタイムとの適合。
ExpressNode.jsのWebサーバー構築。既存のコードとミドルウェア、チームの経験。
Next.jsReactの画面、ルーティング、サーバー側処理。画面とサーバー処理を一体で作る必要性。

Next.jsの画面とHonoのAPIを組み合わせることもできます。ただし、分離すると認証・デプロイ・監視の対象が増えるため、小さいサービスで必ず分ける必要はありません。各製品の対象範囲はExpress公式とNext.js公式も確認してください。

公開前に確認したいこと

入力検証、認証・認可、秘密情報の保管、必要な範囲だけのCORS、エラー時に内部情報を返さないことを確認します。Node.jsで作ったコードをWorkersへ移す場合は、ファイルアクセスやDBドライバーなどの互換性も点検します。まずは上の3つの応答(200・400・404)を確かめ、その後に保存処理や認証を追加すると、問題を切り分けやすくなります。

関連:JWTの仕組みと安全な検証/Prismaでデータベースを扱う。

\ 最新情報をチェック /

記事一覧に戻る

コメントを書く

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です