一覧
標準のミドルウェアを、何のためのものか 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() | 言語を決める |
運用
ほかに、serveStatic()(静的ファイル)、otel()(OpenTelemetry)、metrics()(Prometheus)、contextStorage() も、ミドルウェアとして付けます。
登録する順番
いくつかのミドルウェアは、順番に決まりがあります。
cors()は、basicAuth()/bearerAuth()より先compress()は、etag()より先cache()は、etag()より先prettyJSON()は、compress()とetag()のあと