本文へ移動
Senri
リクエストとレスポンス

Context

ハンドラーとミドルウェアが受け取る c でできること

ハンドラーの 2 つ目の引数と、ミドルウェアの 1 つ目の引数は、そのリクエストの Context(c)です。

import {  } from "@senrijs/senri";

const  = <{ : string }>();

.(async (, ) => {
    .("user", "alice");          // ハンドラーへ値を渡す
    await ();
});

.("/users/:id", ({  }, ) => {
    .("cache-control", "no-store");
    return { , : .("user"), : .("page") };
});

リクエストを読む

書き方中身
c.req本物の Request
c.path正規化してデコードしたパス
c.route当たったルートのパターン("/users/:id")。なければ undefined
c.paramsパスのパラメーター(ハンドラーの 1 つ目の引数と同じ)
c.query(name) / c.query()クエリの値 1 つ / 全部
c.queries(name)同じ名前のクエリを全部(配列)
c.body()本文を Content-Type に合わせて読む(本文の読み方と上限)
c.bodyJson() / c.bodyBytes()本文を JSON / ArrayBuffer と決めて読む
c.valid(target)スキーマで確かめた値(バリデーション)

c.route と c.params は、ミドルウェアの next() の前から読めます。ルートは、ミドルウェアより先に決まるためです。

レスポンスを決める

書き方すること
c.status(code)返す値の status を決める
c.header(name, value)レスポンスにヘッダーを足す
c.json()・c.text()・c.html()・c.redirect()Response を作る(レスポンスのヘルパー)
c.notFound()404 のハンドラーに回す(見つからないとき)

c.header() で足したヘッダーは、最後に 1 回だけレスポンスに付きます。Response を直接返したときも、エラーのときも付きます。ただし Content-Type と Location は、レスポンスにあればそちらが優先です。

値を渡す(c.set / c.get)

ミドルウェアからハンドラーへ値を渡すには、c.set() と c.get() を使います。型は createApp<{ user: string }>() のように決めます。ミドルウェアの型から決めることもできます(ミドルウェアを書く)。

Cloudflare Workers の env と ctx

c.env と c.executionCtx で、Workers のバインディングと waitUntil() を使えます(Cloudflare Workers)。

このページの内容