例外 - `HTTPException` と `WebSocketException`¶

これらは、クライアントにエラーを表示するために発生させることができる例外です。

例外を発生させると、通常の Python と同様に、それ以降の実行は中止されます。この方法により、コードのどこからでもこれらの例外を発生させて、リクエストを中止し、クライアントにエラーを表示できます。

使用できるもの

HTTPException
WebSocketException

これらの例外は fastapi から直接インポートできます。

from fastapi import HTTPException, WebSocketException

fastapi.HTTPException ¶

HTTPException(status_code, detail=None, headers=None)

基底: HTTPException

クライアントにエラーを表示するために独自のコードで発生させることができる HTTP 例外。

これはクライアントエラー、無効な認証、無効なデータなどのためのものであり、コード内のサーバーエラーのためではありません。

詳細については、FastAPI のエラー処理に関するドキュメントをお読みください。

例¶

from fastapi import FastAPI, HTTPException

app = FastAPI()

items = {"foo": "The Foo Wrestlers"}


@app.get("/items/{item_id}")
async def read_item(item_id: str):
    if item_id not in items:
        raise HTTPException(status_code=404, detail="Item not found")
    return {"item": items[item_id]}

パラメータ	説明
`status_code`	クライアントに送信する HTTP ステータスコード。型: `int`
`detail`	JSON レスポンスの `detail` キーでクライアントに送信されるすべてのデータ。型: `Any` デフォルト: `None`
`headers`	レスポンスでクライアントに送信するすべてのヘッダー。型: `Optional[Dict[str, str]]` デフォルト: `None`

ソースコード: fastapi/exceptions.py

def __init__(
    self,
    status_code: Annotated[
        int,
        Doc(
            """
            HTTP status code to send to the client.
            """
        ),
    ],
    detail: Annotated[
        Any,
        Doc(
            """
            Any data to be sent to the client in the `detail` key of the JSON
            response.
            """
        ),
    ] = None,
    headers: Annotated[
        Optional[Dict[str, str]],
        Doc(
            """
            Any headers to send to the client in the response.
            """
        ),
    ] = None,
) -> None:
    super().__init__(status_code=status_code, detail=detail, headers=headers)

status_code `instance-attribute` ¶

status_code = status_code

detail `instance-attribute` ¶

detail = detail

headers `instance-attribute` ¶

headers = headers

fastapi.WebSocketException ¶

WebSocketException(code, reason=None)

基底: WebSocketException

クライアントにエラーを表示するために独自のコードで発生させることができる WebSocket 例外。

これはクライアントエラー、無効な認証、無効なデータなどのためのものであり、コード内のサーバーエラーのためではありません。

FastAPI の WebSockets に関するドキュメントで詳細を読むことができます。

例¶

from typing import Annotated

from fastapi import (
    Cookie,
    FastAPI,
    WebSocket,
    WebSocketException,
    status,
)

app = FastAPI()

@app.websocket("/items/{item_id}/ws")
async def websocket_endpoint(
    *,
    websocket: WebSocket,
    session: Annotated[str | None, Cookie()] = None,
    item_id: str,
):
    if session is None:
        raise WebSocketException(code=status.WS_1008_POLICY_VIOLATION)
    await websocket.accept()
    while True:
        data = await websocket.receive_text()
        await websocket.send_text(f"Session cookie is: {session}")
        await websocket.send_text(f"Message text was: {data}, for item ID: {item_id}")

パラメータ	説明
`code`	仕様で定義されている有効なコードからのクローズコード。型: `int`
`reason`	WebSocket 接続を閉じる理由。これは UTF-8 エンコードされたデータです。理由の解釈はアプリケーションに委ねられており、WebSocket 仕様では指定されていません。人間が読める、またはクライアントコードで解釈できるテキストなどを含む場合があります。型: `Union[str, None]` デフォルト: `None`

ソースコード: fastapi/exceptions.py

def __init__(
    self,
    code: Annotated[
        int,
        Doc(
            """
            A closing code from the
            [valid codes defined in the specification](https://datatracker.ietf.org/doc/html/rfc6455#section-7.4.1).
            """
        ),
    ],
    reason: Annotated[
        Union[str, None],
        Doc(
            """
            The reason to close the WebSocket connection.

            It is UTF-8-encoded data. The interpretation of the reason is up to the
            application, it is not specified by the WebSocket specification.

            It could contain text that could be human-readable or interpretable
            by the client code, etc.
            """
        ),
    ] = None,
) -> None:
    super().__init__(code=code, reason=reason)

code `instance-attribute` ¶

code = code

reason `instance-attribute` ¶

reason = reason or ''

例外 - HTTPException と WebSocketException¶

fastapi.HTTPException ¶

例¶

status_code instance-attribute ¶

detail instance-attribute ¶

headers instance-attribute ¶