Response 类

你可以在路径操作函数或依赖项中声明一个参数为 Response 类型，然后你可以为响应设置数据，如头信息或 Cookie。

你也可以直接使用它来创建一个实例并从你的路径操作中返回它。

你可以直接从 fastapi 中导入它

from fastapi import Response

fastapi.Response

Response(
    content=None,
    status_code=200,
    headers=None,
    media_type=None,
    background=None,
)

参数	描述
content	类型: Any 默认值: None
status_code	类型: int 默认值: 200
headers	类型: Mapping[str, str] | None 默认值: None
media_type	类型: str | None 默认值: None
background	类型: BackgroundTask | None 默认值: None

starlette/responses.py 中的源代码

def __init__(
    self,
    content: typing.Any = None,
    status_code: int = 200,
    headers: typing.Mapping[str, str] | None = None,
    media_type: str | None = None,
    background: BackgroundTask | None = None,
) -> None:
    self.status_code = status_code
    if media_type is not None:
        self.media_type = media_type
    self.background = background
    self.body = self.render(content)
    self.init_headers(headers)

media_type 类属性 实例属性

media_type = None

charset 类属性 实例属性

charset = 'utf-8'

status_code 实例属性

status_code = status_code

background 实例属性

background = background

body instance-attribute

body = render(content)

headers property

headers

render

render(content)

参数	描述
content	类型: Any

starlette/responses.py 中的源代码

def render(self, content: typing.Any) -> bytes | memoryview:
    if content is None:
        return b""
    if isinstance(content, (bytes, memoryview)):
        return content
    return content.encode(self.charset)  # type: ignore

init_headers

init_headers(headers=None)

参数	描述
headers	类型: Mapping[str, str] | None 默认值: None

starlette/responses.py 中的源代码

def init_headers(self, headers: typing.Mapping[str, str] | None = None) -> None:
    if headers is None:
        raw_headers: list[tuple[bytes, bytes]] = []
        populate_content_length = True
        populate_content_type = True
    else:
        raw_headers = [(k.lower().encode("latin-1"), v.encode("latin-1")) for k, v in headers.items()]
        keys = [h[0] for h in raw_headers]
        populate_content_length = b"content-length" not in keys
        populate_content_type = b"content-type" not in keys

    body = getattr(self, "body", None)
    if (
        body is not None
        and populate_content_length
        and not (self.status_code < 200 or self.status_code in (204, 304))
    ):
        content_length = str(len(body))
        raw_headers.append((b"content-length", content_length.encode("latin-1")))

    content_type = self.media_type
    if content_type is not None and populate_content_type:
        if content_type.startswith("text/") and "charset=" not in content_type.lower():
            content_type += "; charset=" + self.charset
        raw_headers.append((b"content-type", content_type.encode("latin-1")))

    self.raw_headers = raw_headers

set_cookie

set_cookie(
    key,
    value="",
    max_age=None,
    expires=None,
    path="/",
    domain=None,
    secure=False,
    httponly=False,
    samesite="lax",
)

参数	描述
key	类型: str
value	类型: str 默认值: ''
max_age	类型: int | None 默认值: None
expires	类型: datetime | str | int | None 默认值: None
path	类型: str | None 默认值: '/'
domain	类型: str | None 默认值: None
secure	类型: bool 默认值: False
httponly	类型: bool 默认值: False
samesite	类型: Literal['lax', 'strict', 'none'] | None 默认值: 'lax'

starlette/responses.py 中的源代码

def set_cookie(
    self,
    key: str,
    value: str = "",
    max_age: int | None = None,
    expires: datetime | str | int | None = None,
    path: str | None = "/",
    domain: str | None = None,
    secure: bool = False,
    httponly: bool = False,
    samesite: typing.Literal["lax", "strict", "none"] | None = "lax",
) -> None:
    cookie: http.cookies.BaseCookie[str] = http.cookies.SimpleCookie()
    cookie[key] = value
    if max_age is not None:
        cookie[key]["max-age"] = max_age
    if expires is not None:
        if isinstance(expires, datetime):
            cookie[key]["expires"] = format_datetime(expires, usegmt=True)
        else:
            cookie[key]["expires"] = expires
    if path is not None:
        cookie[key]["path"] = path
    if domain is not None:
        cookie[key]["domain"] = domain
    if secure:
        cookie[key]["secure"] = True
    if httponly:
        cookie[key]["httponly"] = True
    if samesite is not None:
        assert samesite.lower() in [
            "strict",
            "lax",
            "none",
        ], "samesite must be either 'strict', 'lax' or 'none'"
        cookie[key]["samesite"] = samesite
    cookie_val = cookie.output(header="").strip()
    self.raw_headers.append((b"set-cookie", cookie_val.encode("latin-1")))

delete_cookie

delete_cookie(
    key,
    path="/",
    domain=None,
    secure=False,
    httponly=False,
    samesite="lax",
)

参数	描述
key	类型: str
path	类型: str 默认值: '/'
domain	类型: str | None 默认值: None
secure	类型: bool 默认值: False
httponly	类型: bool 默认值: False
samesite	类型: Literal['lax', 'strict', 'none'] | None 默认值: 'lax'

starlette/responses.py 中的源代码

def delete_cookie(
    self,
    key: str,
    path: str = "/",
    domain: str | None = None,
    secure: bool = False,
    httponly: bool = False,
    samesite: typing.Literal["lax", "strict", "none"] | None = "lax",
) -> None:
    self.set_cookie(
        key,
        max_age=0,
        expires=0,
        path=path,
        domain=domain,
        secure=secure,
        httponly=httponly,
        samesite=samesite,
    )