本文へ移動
Senri

一覧

標準のミドルウェアを、何のためのものか 1 行ずつで並べた表

どれも @senrijs/senri から import します(JWT だけは @senrijs/senri/jwt)。使わないものは、バンドルに入りません。

import { , , ,  } from "@senrijs/senri";

const  = ();

.(());
.(());
.("/api", ({ : ["https://example.com"] }));

セキュリティ

ミドルウェアすること
cors()よそのオリジンからの fetch を許す
csrf()よそのサイトからの POST などを 403 にする
secureHeaders()X-Content-Type-Options などの安全のためのヘッダーを付ける
basicAuth() / bearerAuth()Basic 認証・Bearer トークンで守る
jwt()JWT を確かめる
rateLimit()一定の時間に受けるリクエストの数を制限する
ipRestriction()接続元の IP で許す・断る

本文

ミドルウェアすること
bodyLimit()本文の大きさの上限を決める
uploadLimit()アップロードするファイルの大きさ・数・種類を確かめる

レスポンス

ミドルウェアすること
timeout()時間内に終わらなければ 504 を返す
compress()gzip・deflate で圧縮する
etag()ETag を付けて、変わっていなければ 304 を返す
cache()Cache-Control を付ける
prettyJSON()?pretty で JSON を整形する

リクエスト

ミドルウェアすること
requestId()リクエストに ID を付ける
trailingSlash()末尾のスラッシュをそろえる
methodOverride()HTML のフォームから PUT・PATCH・DELETE を送れるようにする
languageDetector()言語を決める

運用

ミドルウェアすること
logger()リクエストを 1 行ずつログに出す
health()/healthz と /readyz に答える

ほかに、serveStatic()(静的ファイル)、otel()(OpenTelemetry)、metrics()(Prometheus)、contextStorage() も、ミドルウェアとして付けます。

登録する順番

いくつかのミドルウェアは、順番に決まりがあります。

  • cors() は、basicAuth() / bearerAuth() より先
  • compress() は、etag() より先
  • cache() は、etag() より先
  • prettyJSON() は、compress() と etag() のあと

このページの内容