Simuler et tester les routes d’API
Testez isolément les gestionnaires de routes et les actions serveur Next.js en simulant la base de données, les appels réseau et les services externes avec Jest et MSW.
Simuler et tester les routes d’API est une leçon Next.js 15 Fullstack (App Router + Server Actions) gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Next.js 15 Fullstack (App Router + Server Actions), et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Next.js 15 Fullstack (App Router + Server Actions) comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Why Mock?
Tests should be fast, deterministic, and isolated. Mocking replaces slow or external dependencies — databases, payment APIs, email senders — with controllable stand-ins so a single failure does not break unrelated tests.
What to Mock
Good mock targets in a Next.js app:
- The database client (Prisma)
- External HTTP calls (Stripe, OpenAI)
- Auth/session helpers
Keep the route's own logic real so you actually test it.
A Simple Route Handler
Here is a route we want to test. It reads a query param and returns JSON.
// app/api/user/route.ts
import { prisma } from '@/lib/prisma';
export async function GET(req: Request) {
const users = await prisma.user.findMany();
return Response.json(users);
}Mocking Prisma with Jest
jest.mock replaces a module. Mock the Prisma module so calls return fixed data instead of hitting a real database.
jest.mock('@/lib/prisma', () => ({
prisma: {
user: { findMany: jest.fn() }
}
}));Setting Return Values
In each test, tell the mock what to resolve with using mockResolvedValue. This drives the route down a specific path.
import { prisma } from '@/lib/prisma';
(prisma.user.findMany as jest.Mock).mockResolvedValue([
{ id: 1, name: 'Ada' }
]);Invoking the Handler
Route Handlers are plain functions. Call them directly with a Request and assert on the returned Response.
import { GET } from '@/app/api/user/route';
const res = await GET(new Request('http://test/api/user'));
const data = await res.json();
expect(data[0].name).toBe('Ada');Asserting Call Behavior
Verify the mock was used correctly with matchers like toHaveBeenCalledWith. This confirms your route passes the right arguments.
expect(prisma.user.findMany).toHaveBeenCalledTimes(1);Mocking External HTTP with MSW
For outbound calls, MSW (Mock Service Worker) intercepts requests at the network layer. Define handlers that return canned responses.
import { http, HttpResponse } from 'msw';
export const handlers = [
http.get('https://api.stripe.com/v1/charges', () =>
HttpResponse.json({ amount: 500 })
)
];Starting the Mock Server
Boot the MSW server in your test setup so every test runs against the mocked network. Reset handlers between tests for isolation.
import { setupServer } from 'msw/node';
const server = setupServer(...handlers);
beforeAll(() => server.listen());
afterEach(() => server.resetHandlers());
afterAll(() => server.close());Testing Error Paths
Make mocks reject or return errors to test how your route handles failures, ensuring it returns the right status code.
(prisma.user.findMany as jest.Mock).mockRejectedValue(new Error('db down'));
const res = await GET(new Request('http://test/api/user'));
expect(res.status).toBe(500);Best Practices
Keep mocked tests trustworthy:
- Mock the edges, keep logic real
- Reset mocks between tests
- Cover success and error paths
- Use MSW for realistic network mocking
Quick Check
Test your mocking knowledge.
Recap
You learned to test routes in isolation:
- Mock the Prisma client with
jest.mockandmockResolvedValue - Call Route Handlers directly and assert on the
Response - Intercept outbound HTTP with MSW
- Cover error paths by making mocks reject
Your API tests are now fast and reliable.
Questions Fréquemment Posées
La leçon « Simuler et tester les routes d’API » est-elle gratuite ?
Oui — le texte complet de « Simuler et tester les routes d’API » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Next.js 15 Fullstack (App Router + Server Actions), passe à CoddyKit PRO. Le cours Next.js 15 Fullstack (App Router + Server Actions) comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Simuler et tester les routes d’API » ?
Testez isolément les gestionnaires de routes et les actions serveur Next.js en simulant la base de données, les appels réseau et les services externes avec Jest et MSW. Tu pratiques Next.js 15 Fullstack (App Router + Server Actions) avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Next.js 15 Fullstack (App Router + Server Actions) ?
Aucune expérience préalable n'est requise. Next.js 15 Fullstack (App Router + Server Actions) sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Simuler et tester les routes d’API » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Next.js 15 Fullstack (App Router + Server Actions) ?
Oui. Chaque leçon Next.js 15 Fullstack (App Router + Server Actions) inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Tests unitaires des composants
- Tests d’intégration des pages
- Tests de bout en bout avec Playwright/Cypress
- Simuler et tester les routes d’API