本文へ移動
Senri
ミドルウェア

ルートごとに付ける

パスで付ける、表の全部に付ける、1 つのルートだけに付ける

// 表の全部のルートに付ける
export const  = ("/admin", { : [] })({
    "GET /me": (, ) => ({ : .get("user") }),
Context.get(key: "user"): User | undefined

Reads a variable set with Context.set, or undefined if it was not set.

// このルートだけに付ける "DELETE /users/:id": ({ : [] }, async ({ }) => { await (); return { : }; }), }); const = (); .();

付け方

書き方動くところ
app.use(mw)全部のリクエスト
app.use("/admin", mw)/admin とその下
defineRoutes(prefix, { use: [mw] })その表のルート
endpoint({ use: [mw] }, handler)そのルートだけ

表とルートの use は、そのルートに当たったリクエストでだけ動きます。前置きのない表に付けるときは、defineRoutes("", { use }) と書きます。

動く順番

  1. アプリの app.use()
  2. 表の use
  3. ルートの use
  4. スキーマの確認(本文を読む)
  5. ハンドラー

ミドルウェアが値を返したら、スキーマの確認の前に止まります。認証に通らないリクエストの本文は読みません。

型

Middleware<{ user: User }> と書いたミドルウェアを use に入れると、そのルートの c.get("user") に型が付きます。

上限を上げる

既定の本文の上限(1 MiB)を、1 つのルートだけで上げるのにも使えます。

const  = ({
    "POST /import": ({ : [({ : 20 * 1024 * 1024 })] }, async (, ) => {
        const  = await ..();
        return { : .length };
    }),
});

このページの内容