Sự cố thực tế: Staging API sập lúc 2 giờ sáng
2 giờ sáng. Ly cà phê thứ tư đã nguội ngắt. Màn hình CI/CD đỏ rực với 42 test cases báo lỗi hàng loạt. 9 giờ sáng cùng ngày là hạn chót bàn giao tính năng thanh toán. Đúng lúc này, server staging của backend quá tải vì rò rỉ bộ nhớ (OOM) rồi ngừng hoạt động.
Frontend hoàn toàn tê liệt. Test thủ công không chạy được. Test tự động với Vitest văng liên tiếp các lỗi ECONNREFUSED và 504 Gateway Timeout. Cả dự án kẹt cứng vì phụ thuộc tuyệt đối vào độ ổn định của backend.
Để kịp tiến độ, vài bạn vội chèn tạm const fakeUser = {...} thẳng vào component. Giải pháp tình thế này suýt lọt lên nhánh production qua đợt review vội vã. Phụ thuộc hạ tầng staging khi dev giao diện là rủi ro rất lớn, thay vì tách biệt để kiểm thử UI component độc lập ngay từ đầu.
Nhìn lại nguyên nhân: 2 sai lầm phổ biến khi mock API
Sự cố trên phơi bày điểm yếu cốt lõi: chúng ta đang giả lập dữ liệu sai vị trí.
- Chèn mock trực tiếp vào Component: Gán dữ liệu giả vào local state hoặc hook gọi API. Cách này làm rối logic nghiệp vụ. Trước khi merge code, bạn phải lục tìm từng file để xóa bỏ dữ liệu test. Chỉ một phút sơ suất, dữ liệu mẫu sẽ trôi thẳng ra màn hình người dùng thật.
- Mock đè module HTTP (như Axios hay Fetch): Dùng
vi.mock('axios')để ép hàm trả về data mong muốn. Kỹ thuật này chỉ chạy được trong môi trường Node.js khi chạy test, không hỗ trợ khi mở browser dev local. Quan trọng hơn, mock module không kiểm tra được tính toàn vẹn của HTTP headers, query params, cookies hay status codes.
Khi mock module, bạn chỉ đang kiểm tra xem hàm của mình có gọi thư viện mạng hay không — một nguyên nhân phổ biến dẫn đến code coverage ảo khi bài test hoàn toàn bỏ qua việc ứng dụng xử lý phản hồi thực tế từ mạng ra sao.
So sánh các giải pháp mock thông dụng
Trước khi chọn hướng tiếp cận chuẩn, dự án từng thử qua 3 giải pháp quen thuộc:
1. Hardcode dữ liệu mẫu vào component
// Trộn lẫn dữ liệu test vào code giao diện
const UserProfile = () => {
// const { data } = useFetch('/api/user');
const data = { id: 'usr-01', name: 'Nguyen Van A', role: 'admin' }; // Nhớ xóa trước khi commit!
return <div>{data.name}</div>;
};
Giao diện hiển thị ngay lập tức. Đổi lại, nguy cơ sót dữ liệu giả lên production rất cao, đồng thời bạn không thể tái sử dụng cho test tự động.
2. Mock hàm axios bằng Jest hoặc Vitest
import axios from 'axios';
vi.mock('axios');
test('hiển thị thông tin user', async () => {
vi.mocked(axios.get).mockResolvedValue({
data: { id: 'usr-01', name: 'Nguyen Van A' }
});
// Logic kiểm thử...
});
Bộ test trên CI chạy được, nhưng rất dễ vỡ. Nếu bạn chuyển từ axios sang fetch native, hàng loạt test case sẽ hỏng dù giao diện người dùng không đổi. Ngoài ra, dữ liệu mock này không dùng được khi bật trình duyệt kiểm tra thực tế.
3. Dựng mock server riêng bằng Express hoặc JSON-Server
Tạo một service Node.js chạy tại cổng localhost:4000 để trả JSON mẫu. Cách làm này sát với môi trường thật hơn. Tuy nhiên, chi phí bảo trì tăng đáng kể: bạn phải cấu hình proxy, quản lý tiến trình phụ, và thêm bước khởi động server chờ sẵn trong pipeline CI/CD.
Giải pháp: Chặn request ở tầng Network với Mock Service Worker (MSW)
Mock Service Worker (MSW) xử lý triệt để các vấn đề trên. Thay vì can thiệp vào code JavaScript hay dựng server riêng, MSW đón đầu request ngay tại tầng Network.
Trên trình duyệt, MSW dùng Service Worker API chuẩn để bắt request. Trong môi trường test (Node.js), thư viện sử dụng cơ chế class interception tương thích. Dù bạn gọi API qua fetch, axios hay các giải pháp quản lý server state như TanStack Query, ứng dụng React vẫn gửi request HTTP bình thường. MSW đứng tại cổng mạng, trả về dữ liệu mẫu mà không cần kết nối tới backend.
Trong một dự án refactor hơn 35.000 dòng code React, tôi từng dùng MSW để dựng toàn bộ 15 kịch bản lỗi mạng, mã 401, 500 và timeout trước khi sửa logic component. Nhờ đó, quá trình nâng cấp diễn ra an toàn, không làm phát sinh lỗi hồi quy.
Bước 1: Cài đặt MSW 2.x vào dự án
Cài đặt gói msw vào nhóm dev dependencies:
npm install msw@latest --save-dev
# hoặc dùng pnpm
pnpm add -D msw@latest
Tạo file worker cho trình duyệt (đặt trong thư mục public/ của Vite hoặc Create React App):
npx msw init public/ --save
Lệnh này tạo file mockServiceWorker.js và lưu cấu hình vào package.json để tự động đồng bộ khi bạn cập nhật phiên bản thư viện.
Bước 2: Xây dựng Network Handlers với TypeScript
Tạo thư mục src/mocks/ để lưu trữ tập trung các endpoint cần giả lập:
// src/mocks/handlers.ts
import { http, HttpResponse, delay } from 'msw';
interface UserProfileResponse {
id: string;
name: string;
email: string;
role: 'admin' | 'user';
}
export const handlers = [
// Endpoint GET lấy thông tin tài khoản
http.get('/api/user/profile', async () => {
// Giả lập độ trễ mạng 150ms
await delay(150);
return HttpResponse.json<UserProfileResponse>({
id: 'usr-9821',
name: 'Le Quoc Bao',
email: '[email protected]',
role: 'admin',
}, { status: 200 });
}),
// Endpoint POST xử lý thanh toán đơn hàng
http.post('/api/checkout', async ({ request }) => {
const payload = (await request.json()) as { amount: number };
// Giả lập trường hợp vượt hạn mức thanh toán
if (payload.amount > 50_000_000) {
return HttpResponse.json(
{ error: 'Số tiền thanh toán vượt quá hạn mức 50 triệu VNĐ' },
{ status: 400 }
);
}
return HttpResponse.json({
success: true,
transactionId: 'txn-883921'
}, { status: 201 });
}),
];
Bước 3: Kích hoạt MSW trên trình duyệt khi phát triển local
Khởi tạo worker cho browser để bắt request trực tiếp trên Chrome hoặc Firefox:
// src/mocks/browser.ts
import { setupWorker } from 'msw/browser';
import { handlers } from './handlers';
export const worker = setupWorker(...handlers);
Khởi động worker trong src/main.tsx khi ứng dụng chạy ở môi trường development:
// src/main.tsx
import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App';
async function prepareEnvironment() {
// Kiểm tra môi trường dev trên Vite (hoặc dùng process.env.NODE_ENV trên CRA/Webpack)
if (import.meta.env.DEV) {
const { worker } = await import('./mocks/browser');
return worker.start({
onUnhandledRequest: 'bypass',
});
}
}
prepareEnvironment().then(() => {
ReactDOM.createRoot(document.getElementById('root')!).render(
<React.StrictMode>
<App />
</React.StrictMode>
);
});
Mở Console trong DevTools, bạn sẽ thấy thông báo: [MSW] Mocking enabled. Trên tab Network, các request khớp với handler sẽ có biểu tượng bánh răng đặc trưng của Service Worker cùng mã 200.
Bước 4: Cấu hình môi trường chạy test (Vitest / Jest)
Trong môi trường Node.js khi chạy test tự động, MSW cung cấp hàm setupServer:
// src/mocks/server.ts
import { setupServer } from 'msw/node';
import { handlers } from './handlers';
export const server = setupServer(...handlers);
Khai báo vòng đời của server trong file cấu hình test src/setupTests.ts:
// src/setupTests.ts
import { beforeAll, afterEach, afterAll } from 'vitest';
import '@testing-library/jest-dom';
import { server } from './mocks/server';
// Khởi động server trước khi chạy test suite
beforeAll(() => server.listen({ onUnhandledRequest: 'error' }));
// Xóa handler tạm thời sau mỗi bài test để tránh xung đột dữ liệu
afterEach(() => server.resetHandlers());
// Tắt server sau khi hoàn tất toàn bộ test
afterAll(() => server.close());
Bước 5: Viết integration test độc lập với backend
Lúc này, bạn có thể kiểm tra cả kịch bản dữ liệu trả về thành công lẫn trường hợp máy chủ gặp sự cố:
// src/components/UserProfile.test.tsx
import { render, screen } from '@testing-library/react';
import { expect, test } from 'vitest';
import { http, HttpResponse } from 'msw';
import { server } from '../mocks/server';
import UserProfile from './UserProfile';
test('hiển thị chính xác tên người dùng nhận từ API', async () => {
render(<UserProfile />);
// Chờ component fetch dữ liệu và hiển thị ra DOM
expect(await screen.findByText('Le Quoc Bao')).toBeInTheDocument();
});
test('hiển thị thông báo khi server phản hồi mã lỗi 500', async () => {
// Ghi đè handler chỉ riêng cho ca kiểm thử này
server.use(
http.get('/api/user/profile', () => {
return new HttpResponse(null, { status: 500 });
})
);
render(<UserProfile />);
expect(await screen.findByText(/không thể tải dữ liệu người dùng/i)).toBeInTheDocument();
});
Các request đều được xử lý hoàn toàn trong bộ nhớ RAM của tiến trình test. Không phụ thuộc đường truyền internet. Không phụ thuộc máy chủ staging.
Khi chạy npm run test trên CI, toàn bộ 42 test cases hoàn thành trơn tru chỉ sau 2,8 giây. Tách rời tầng Network bằng MSW giúp frontend chủ động hoàn toàn về tiến độ phát triển lẫn chất lượng mã nguồn.
