TestClient - Code Search

tests/test_starlette_exception.py

from fastapi import FastAPI, HTTPException
from fastapi.testclient import TestClient
from starlette.exceptions import HTTPException as StarletteHTTPException

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",

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Fri Jun 30 18:25:16 GMT 2023

- 7.4K bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs/ko/docs/advanced/testing-websockets.md

# WebSocket 테스트하기

`TestClient`를 사용하여 WebSocket을 테스트할 수 있습니다.

이를 위해 `with` 문에서 `TestClient`를 사용하여 WebSocket에 연결합니다:

{* ../../docs_src/app_testing/tutorial002.py hl[27:31] *}

/// note | 참고

자세한 내용은 Starlette의 <a href="https://www.starlette.dev/testclient/#testing-websocket-sessions" class="external-link" target="_blank"> WebSocket 테스트</a>에 관한 설명서를 참고하시길 바랍니다.

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Sat Oct 11 17:48:49 GMT 2025

- 501 bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_tutorial/test_behind_a_proxy/test_tutorial001.py

from fastapi.testclient import TestClient

from docs_src.behind_a_proxy.tutorial001_py39 import app

client = TestClient(app, root_path="/api/v1")


def test_main():
    response = client.get("/app")
    assert response.status_code == 200
    assert response.json() == {"message": "Hello World", "root_path": "/api/v1"}


def test_openapi():
    response = client.get("/openapi.json")
    assert response.status_code == 200

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Wed Dec 17 20:41:43 GMT 2025

- 1K bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_openapi_model_description_trim_on_formfeed.py

from fastapi import FastAPI
from fastapi.testclient import TestClient
from pydantic import BaseModel

app = FastAPI()


class MyModel(BaseModel):
    """
    A model with a form feed character in the title.
    \f
    Text after form feed character.
    """


@app.get("/foo")
def foo(v: MyModel):  # pragma: no cover
    pass


client = TestClient(app)


def test_openapi():

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Tue Jun 17 07:46:27 GMT 2025

- 660 bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_tutorial/test_websockets/test_tutorial001.py

import pytest
from fastapi.testclient import TestClient
from fastapi.websockets import WebSocketDisconnect

from docs_src.websockets.tutorial001_py39 import app

client = TestClient(app)


def test_main():
    response = client.get("/")
    assert response.status_code == 200, response.text
    assert b"<!DOCTYPE html>" in response.content


def test_websocket():
    with pytest.raises(WebSocketDisconnect):

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Wed Dec 17 20:41:43 GMT 2025

- 827 bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_request_params/test_body/test_optional_str.py

from typing import Annotated, Optional

import pytest
from fastapi import Body, FastAPI
from fastapi.testclient import TestClient
from pydantic import BaseModel, Field

from .utils import get_body_model_name

app = FastAPI()

# =====================================================================================
# Without aliases


@app.post("/optional-str", operation_id="optional_str")

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Sat Dec 27 18:19:10 GMT 2025

- 11.6K bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_tutorial/test_metadata/test_tutorial002.py

from fastapi.testclient import TestClient

from docs_src.metadata.tutorial002_py39 import app

client = TestClient(app)


def test_items():
    response = client.get("/items/")
    assert response.status_code == 200, response.text
    assert response.json() == [{"name": "Foo"}]


def test_get_openapi_json_default_url():
    response = client.get("/openapi.json")
    assert response.status_code == 404, response.text

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Fri Dec 26 10:43:02 GMT 2025

- 1.2K bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_include_route.py

from fastapi import APIRouter, FastAPI, Request
from fastapi.responses import JSONResponse
from fastapi.testclient import TestClient

app = FastAPI()
router = APIRouter()


@router.route("/items/")
def read_items(request: Request):
    return JSONResponse({"hello": "world"})


app.include_router(router)

client = TestClient(app)


def test_sub_router():
    response = client.get("/items/")

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Wed Apr 08 04:37:38 GMT 2020

- 496 bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs/pt/docs/advanced/testing-websockets.md

Você pode usar o mesmo `TestClient` para testar WebSockets.

Para isso, você utiliza o `TestClient` dentro de uma instrução `with`, conectando com o WebSocket:

{* ../../docs_src/app_testing/tutorial002_py39.py hl[27:31] *}

/// note | Nota

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Wed Dec 17 20:41:43 GMT 2025

- 497 bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_tutorial/test_response_change_status_code/test_tutorial001.py

from fastapi.testclient import TestClient

from docs_src.response_change_status_code.tutorial001_py39 import app

client = TestClient(app)


def test_path_operation():
    response = client.put("/get-or-create-task/foo")
    print(response.content)
    assert response.status_code == 200, response.text
    assert response.json() == "Listen to the Bar Fighters"
    response = client.put("/get-or-create-task/bar")

Created: Sun Dec 28 07:19:09 GMT 2025

- Last Modified: Wed Dec 17 20:41:43 GMT 2025

- 526 bytes

- Click Count (0)

Search Options