SuperAPI AI 工具集

msw

编程与开发

查看项目

更新于 10-16 04:54

技能介绍

用途:为 MSW v2 应用提供 API 模拟(mocking)规范,供 AI 代理与 LLM 在测试或开发中参考,指导自动化重构与代码生成。

主要能力:包含 48 条规则,分 8 类并按影响优先级排列。1 设置与初始化(CRITICAL,前缀 setup-):Node.js 使用 msw/node 入口、测试设置中配置服务器生命周期、提交 worker 脚本、要求 Node.js 18+、配置未处理请求行为、配置 TypeScript。2 处理器架构(CRITICAL,handler-):先定义 happy path、按域分组、使用绝对 URL、抽取共享 resolver、使用 v2 响应语法、显式解析请求体、正确解构 resolver 参数、跨环境复用。3 测试集成(HIGH,test-):每个测试后重置处理器、避免直接请求断言、并发测试用 server.boundary()、配置假定时器保留 queueMicrotask、使用异步测试工具、清理请求库缓存、Jest 使用正确 JSDOM 环境。4 响应模式(HIGH,response-):使用 HttpResponse 静态方法、仅在测试时序行为时加延迟、正确模拟错误响应、一次性处理器处理顺序场景、正确设置响应头、用 ReadableStream 模拟流式响应。5 请求匹配(MEDIUM-HIGH,match-):URL 路径参数、查询参数、自定义谓词、显式匹配 HTTP 方法、处理器从具体到通用排序。6 GraphQL 模拟(MEDIUM,graphql-):按操作名匹配、正确格式返回错误、处理批量查询、访问变量、基于 schema 解析。7 高级模式(MEDIUM,advanced-):bypass() 透传、Cookie 与认证、动态场景、Vitest 浏览器模式、文件上传、用 ws.link 模拟 WebSocket、@msw/playwright 的 defineNetworkFixture。8 调试与性能(LOW,debug-):生命周期事件、验证拦截、常见问题与修复、请求日志。

使用方式:在项目根目录运行 npx -y @pymodel/react-frontend-skills detect 查看已安装与目标版本,运行 npx -y @pymodel/react-frontend-skills scan --skill msw 将废弃 API 映射到规则 ID;对匹配任务的规则与扫描命中项,阅读 references/<rule-id>.md 了解原因及错误与正确代码对比。

适用场景:为测试或开发设置 MSW、编写或组织请求处理器、配置测试环境、模拟 REST 或 GraphQL API、调试处理器匹配问题、测试错误状态与边界情况。

限制:资料未提供收费、价格、平台支持范围等具体信息。