api-mock-templates

API Mock Templates Reference

Templates for mock server implementation using MSW (Mock Service Worker) for Node.js/React.

MSW Setup

Installation

npm install msw --save-dev

Mock Server Handler (Node.js)

// mocks/handlers.ts
import { http, HttpResponse, delay } from 'msw';

// Define API mocks
export const handlers = [
    // GET list with pagination
    http.get('/api/patients', async ({ request }) => {
        const url = new URL(request.url);
        const page = parseInt(url.searchParams.get('page') || '1');
        const pageSize = parseInt(url.searchParams.get('pageSize') || '20');

        await delay(100); // Simulate network latency

        return HttpResponse.json({
            items: generatePatients(pageSize, page),
            totalCount: 150,
            pageNumber: page,
            pageSize: pageSize,
        });
    }),

    // GET single resource
    http.get('/api/patients/:id', async ({ params }) => {
        const { id } = params;

        if (id === 'not-found') {
            return HttpResponse.json(
                { error: { code: 'NOT_FOUND', message: 'Patient not found' } },
                { status: 404 }
            );
        }

        return HttpResponse.json({
            id,
            name: 'John Doe',
            email: '[email protected]',
            status: 'Active',
        });
    }),

    // POST create resource
    http.post('/api/patients', async ({ request }) => {
        const body = await request.json();

        // Simulate validation error
        if (!body.email) {
            return HttpResponse.json(
                { error: { code: 'VALIDATION_ERROR', details: [{ field: 'email', message: 'Email is required' }] } },
                { status: 422 }
            );
        }

        return HttpResponse.json(
            { id: crypto.randomUUID(), ...body },
            { status: 201 }
        );
    }),

    // PUT update resource
    http.put('/api/patients/:id', async ({ params, request }) => {
        const { id } = params;
        const body = await request.json();

        return HttpResponse.json({ id, ...body });
    }),

    // DELETE resource
    http.delete('/api/patients/:id', async ({ params }) => {
        return new HttpResponse(null, { status: 204 });
    }),
];