FastAPI sangat mudah diuji berkat TestClient-nya (dibangun di atas Starlette/httpx) dan sistem dependency injection-nya, yang membuat mocking dependencies menjadi trivial. Test biasanya menggunakan pytest dan TestClient untuk mengirim permintaan ke app tanpa server yang berjalan.
from fastapi.testclient import TestClient
from main import app
client = TestClient(app)
def test_read_item():
response = client.get("/items/5") # send a request to the app in-process
assert response.status_code == 200
assert response.json() == {"item_id": 5}
def test_create_item():
response = client.post("/items", json={"name": "Phone", "price": 999})
assert response.status_code == 201
assert response.json()["name"] == "Phone"
def test_validation_error():
response = client.post("/items", json={"name": "Phone"}) # missing price
assert response.status_code == 422 # FastAPI validates automatically
TestClient mengirim permintaan nyata ke app Anda secara in-process (tidak perlu server), sehingga Anda menguji alur lengkap — routing, validasi, serialisasi — dan assert pada status code dan respons JSON.
# override a dependency with a mock/test version — no real database needed
def override_get_db():
return test_db_session
app.dependency_overrides[get_db] = override_get_db # swap the real dependency
def test_with_test_db():
response = client.get("/users")
# uses the test database via the override
app.dependency_overrides.clear() # reset after
dependency_overrides FastAPI memungkinkan Anda mengganti dependency apa pun (sesi database, auth, layanan eksternal) dengan test double — fondasi dari test yang cepat dan terisolasi, dibuat trivial oleh desain DI.
def test_protected():
# override the auth dependency to simulate a logged-in user
app.dependency_overrides[get_current_user] = lambda: fake_user
response = client.get("/me")
assert response.status_code == 200
✓ Use a TEST database (separate, or transactions rolled back per test)
✓ Override dependencies (DB, auth, external APIs) for isolation
✓ Test: status codes, response shapes, validation (422s), auth/permissions, edge cases
✓ For async-specific code, use httpx.AsyncClient / pytest-asyncio
✓ Tools: pytest, factory libraries for test data, coverage.py
Pengujian sangat penting untuk aplikasi yang andal, dan FastAPI sangat mudah diuji — memahami cara mengujinya penting untuk kualitas kode dan karena framework dirancang untuk testability.
TestClient membuat mudah untuk menguji alur request/response lengkap secara in-process (tidak perlu server), memverifikasi routing, validasi, serialisasi, dan respons seperti yang akan dialami klien.
Fitur yang menonjol adalah dependency overrides: karena FastAPI menggunakan dependency injection, Anda dapat dengan trivial mengganti dependency apa pun — sesi database, authentication, layanan eksternal — dengan test doubles melalui app.dependency_overrides, memungkinkan test yang cepat dan terisolasi tanpa infrastruktur nyata (testability ini adalah manfaat utama dari desain DI).
Mengetahui cara menggunakan TestClient, mengganti dependencies untuk isolasi (database test, auth/services yang dimock), menguji endpoint yang dilindungi, dan menyusun strategi pengujian yang masuk akal (status code, bentuk respons, validasi, auth, edge case) adalah pengetahuan tingkat senior yang penting untuk membangun aplikasi FastAPI yang robust.
API yang teruji dengan baik menangkap regresi dan memungkinkan refactoring yang percaya diri, dan alat pengujian FastAPI membuat pengujian menyeluruh menjadi mudah, menjadikan topik ini frequently-relevant dan professionally-important.