Mock Service Worker
JavaScript 的 API 模拟库,在网络层拦截请求而不改 fetch 或 axios,同一份 mock 定义可服务浏览器与测试环境,适合前端开发者本地开发时摆脱对后端环境的依赖。
4 次可以打开平均 1.4 秒11 月 19 日 起国内不可直接访问
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。Mock Service Worker(简称 MSW)是一个 JavaScript 的 API 模拟库,用来在开发和测试时伪造后端接口的响应。它不修改 window.fetch 或 axios 这类客户端代码,而是在网络层拦截请求:浏览器里借助 Service Worker API,Node.js 里通过 @mswjs/interceptors 在 socket 层接管连接。因此同一份 mock 定义可以同时服务 fetch、axios、useSWR 等不同调用方式。
主要功能
用 http.get、http.post 这类方法声明请求处理器,返回 HttpResponse.json 构造的响应。除了 REST,还能模拟 GraphQL、Server-Sent Events 和 WebSocket,在同一个网络契约里并存。处理器可以按需在运行时替换,比如在组件里临时让某个接口返回 429,观察 UI 对限流的处理。
配套项目把能力往外扩:Source 从 OpenAPI 文档和 HAR 文件生成请求处理器;Data 用类似 ORM 的语法建模、播种和查询数据;Serve 把处理器变成真实的 HTTP 服务器,或作为 Express、Hono、Fastify 的中间件使用。
适合谁
前端开发者可以在本地开发时摆脱对后端环境的依赖;测试人员能把它接入 Vitest、Playwright、Storybook,让组件测试和端到端测试拥有稳定可预测的网络层。官网称它被不少团队用于生产级应用的开发与测试流程。
费用与限制
项目开源,代码托管在 GitHub,文档和 API 参考在官网免费查阅。浏览器端依赖 Service Worker,需要 HTTPS 或 localhost 环境;Node.js 端通过拦截器工作,对运行环境有版本要求。具体支持范围以文档为准。
