In day-to-day development, MSW (Mock Service Worker) API mocking is being used more and more frequently. This article systematically explains its usage, principles, and optimization strategies.
Quick Start
The key is to understand the core logic:
import { render, screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import { LoginForm } from './LoginForm'
describe('LoginForm', () => {
it('提交有效的登录表单', async () => {
const onSubmit = jest.fn()
render(<LoginForm onSubmit={onSubmit} />)
await userEvent.type(screen.getByLabelText(/邮箱/), 'user@example.com')
await userEvent.type(screen.getByLabelText(/密码/), 'password123')
await userEvent.click(screen.getByRole('button', { name: /登录/ }))
await waitFor(() => {
expect(onSubmit).toHaveBeenCalledWith({
email: 'user@example.com', password: 'password123'
})
})
})
})
Performance optimization needs to be tied to the specific scenario; not everything needs to be over-optimized.
Internal Principles
We can improve it in the following ways:
import { test, expect } from '@playwright/test'
test.describe('用户登录流程', () => {
test('成功登录跳转到首页', async ({ page }) => {
await page.goto('/login')
await page.fill('[data-testid="email"]', 'admin@example.com')
await page.fill('[data-testid="password"]', 'admin123')
await page.click('[data-testid="submit-btn"]')
await expect(page).toHaveURL('/dashboard')
await expect(page.locator('.welcome')).toContainText('欢迎回来')
})
})
This approach has been running stably in production for over half a year and has been validated in practice.
Business Practice
Let's first look at the basic implementation:
import { render, screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import { LoginForm } from './LoginForm'
describe('LoginForm', () => {
it('提交有效的登录表单', async () => {
const onSubmit = jest.fn()
render(<LoginForm onSubmit={onSubmit} />)
await userEvent.type(screen.getByLabelText(/邮箱/), 'user@example.com')
await userEvent.type(screen.getByLabelText(/密码/), 'password123')
await userEvent.click(screen.getByRole('button', { name: /登录/ }))
await waitFor(() => {
expect(onSubmit).toHaveBeenCalledWith({
email: 'user@example.com', password: 'password123'
})
})
})
})
This snippet shows the basic usage. In real projects you'll also need to consider error handling and edge cases.
Performance Comparison
Building on this, we can optimize further:
import { test, expect } from '@playwright/test'
test.describe('用户登录流程', () => {
test('成功登录跳转到首页', async ({ page }) => {
await page.goto('/login')
await page.fill('[data-testid="email"]', 'admin@example.com')
await page.fill('[data-testid="password"]', 'admin123')
await page.click('[data-testid="submit-btn"]')
await expect(page).toHaveURL('/dashboard')
await expect(page.locator('.welcome')).toContainText('欢迎回来')
})
})
This pattern is very useful in large projects and can significantly cut maintenance cost.
Summary
- MSW API mocking is no silver bullet; choose it based on your project's size and tech stack.
- Understanding the underlying principles matters more than memorizing APIs.
- Be sure to verify compatibility before using it in production.
- On a team, conventions and documentation matter more than the tech itself.
