测试质量保障前端接口测试【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址https://gitcode.com/GitHub_Trending/cy/cypress点击查看免费下载导读packages/net-stubbing是 Cypress 中负责网络拦截network stubbing服务端实现的核心包它承载了cy.intercept()在后端代理层一侧的全部逻辑路由注册、请求/响应拦截、订阅调度与静态响应发送并对外导出供浏览器端driver消费的完整类型定义。阅读本文你将掌握该包在整个 monorepo 中的职责边界、InterceptedRequest订阅机制的底层原理、四类驱动事件的流转路径以及本地构建与单元测试的标准操作方式。包定位服务端实现 类型定义packages/net-stubbing/README.md 对该包的定位给出了明确说明本包包含 Cypress 网络拦截特性的服务端代码与类型定义驱动侧driver代码位于driver包中。服务端代码指运行在 Cypress 代理/运行时一侧的拦截逻辑包括路由匹配、订阅规划、请求响应流处理等全部位于lib/server/目录下类型定义cy.intercept对外暴露的公开 API 类型如RouteMatcher、StaticResponse、CyHttpMessages等并非在本包内手写而是由packages/network-interception包的lib/types/external-types.ts统一维护。构建时 cli/scripts/sync-typedefs.ts 会将该文件逐字复制为cli/types/net-stubbing.d.ts随 Cypress 发布给用户使用——这正是用户侧import cypress/types/net-stubbing的类型来源驱动侧driver浏览器内执行的cy.intercept命令实现位于packages/driver/src/cy/net-stubbing/其端到端行为验证位于 packages/driver/cypress/e2e/commands/net_stubbing.cy.ts。从依赖关系看本包的package.jsonpackages/net-stubbing/package.json声明了packages/network-interception、packages/socket两个内部运行时依赖以及debug、is-html、istextorbinary、lodash、mime、throttle等通用工具库并作为 devDependencies 引入packages/errors、packages/network、packages/proxy、packages/telemetry主入口main指向./lib/server。目录结构服务端核心与适配层packages/net-stubbing/ ├── lib/ │ ├── adapters/ │ │ ├── README.md # 端口/适配器说明 │ │ └── driver-intercept-registration.ts # 驱动事件注册适配器 │ └── server/ │ ├── middleware/ │ │ ├── error.ts # InterceptError 错误中间件 │ │ ├── request.ts # SetMatchingRoutes / InterceptRequest 请求中间件 │ │ └── response.ts # InterceptResponse 响应中间件 │ ├── driver-events.ts # onNetStubbingEvent 事件分发入口 │ ├── handle-intercept-request.ts # 请求拦截编排 │ ├── handle-intercept-response.ts # 响应拦截编排 │ ├── index.ts # 包对外导出 │ ├── intercepted-request.ts # InterceptedRequest 核心类 │ ├── state.ts # NetStubbingState 状态工厂 │ ├── types.ts # 状态类型定义 │ └── util.ts # 静态响应/流/编码工具 └── test/ └── unit/ ├── adapters/driver-intercept-registration.spec.ts ├── driver-events.spec.ts ├── intercepted-request.spec.ts └── util.spec.ts其中 lib/server/index.ts 是本包的对外出口导出了onNetStubbingEvent、DriverInterceptRegistrationAdapter、InterceptError、SetMatchingRoutes、InterceptRequest、InterceptResponse、handleInterceptResponse以及netStubbingState状态实例。这些导出分别被代理层proxy与运行时server所引用。构建开发期免构建生产期一条命令原文档强调开发阶段你通常不需要手动构建 .js 文件。packages/ts提供了 require 时的即时转译require-time transpilation开发时直接运行 TypeScript 源码即可。仅在需要产出编译产物时执行yarn build-prod该命令在 package.json 中实际定义为tsc --project .即使用包内 tsconfig.json继承自../ts/tsconfig.json覆盖lib/*.ts与lib/**/*.ts编译整个包的 TypeScript 源码。除build-prod外该包还提供check-tstsc --noEmit加 tslint 静态检查、lint、test-debugvitest --inspect-brk --no-file-parallelism --test-timeout0与test-watchvitest watch等开发命令。测试单元测试与驱动层行为验证原文档指出测试位于./test运行方式为yarn test对应的 package.json 中test脚本为vitest配置见 vitest.config.ts以 node 环境运行test/**/*.spec.ts下的全部用例并设置CYPRESS_INTERNAL_ENVtest环境变量。当前仓库包含四组单元测试test/unit/adapters/driver-intercept-registration.spec.ts验证适配器如何把route:added、subscribe、event:handler:resolved、send:static:response四类驱动事件转发到onNetStubbingEvent及对应状态test/unit/driver-events.spec.ts验证_restoreMatcherOptionsTypes能将type: regex的序列化匹配器还原为真正的RegExp实例含 flagstest/unit/intercepted-request.spec.ts验证handleSubscriptions对订阅的调度、对 disabled 订阅的跳过test/unit/util.spec.ts验证parseContentType的内容类型推断、getBodyEncoding的 utf8/binary 判定、getBodyStream的 delay 与 throttle 时序。此外原文档特别强调driver包中的net_stubbing_spec会测试本仓库的功能。对应文件即 packages/driver/cypress/e2e/commands/net_stubbing.cy.ts它以真实浏览器端到端的方式覆盖cy.intercept在 driver 与服务端协作下的完整行为是比单元测试更全面的行为级验证。核心状态NetStubbingStatelib/server/types.ts 定义了贯穿整个拦截生命周期的状态结构export interface NetStubbingState { pendingEventHandlers: { [eventId: string]: (opts: { changedData: any, stopPropagation: boolean }) void } requests: { [requestId: string]: InterceptedRequest } routes: BackendRoute[] reset: () void }routes已注册的BackendRoute数组由 driver 的cy.intercept()通过route:added事件写入requests按requestId索引的在途拦截请求供请求/响应/错误中间件按 ID 找回对应对象pendingEventHandlers等待 driver 回执的事件回调表——当订阅需要await时服务端先把 resolve 函数挂在这里driver 处理完成后通过event:handler:resolved事件触发回调reset()清理所有未完成请求移除监听、销毁响应、清空事件处理器与路由表用于测试间隔离。lib/server/state.ts 中state()工厂实现了上述结构并在reset()中显式执行res.removeAllListeners(finish/error)与res.destroy()避免残留请求污染后续测试。该状态实例通过index.ts以netStubbingState名称导出被packages/proxy注入到中间件上下文见 packages/proxy/lib/http/index.ts 中的netStubbingState字段。驱动事件入口onNetStubbingEvent 的四类分发driver 与 net-stubbing 服务端的通信经由 socket 完成。传统路径中socket 收到net事件后调用onNetStubbingEvent在新架构下lib/adapters/driver-intercept-registration.ts 中的DriverInterceptRegistrationAdapter实现了packages/network-interception的ForInterceptRegistration驱动端口把handleEvent(request)转发给同一个onNetStubbingEvent。其调用链为SocketBasedriver 的 net 事件 → ForInterceptRegistration.handleEvent() → DriverInterceptRegistrationAdapter → onNetStubbingEvent()lib/server/driver-events.ts 中的onNetStubbingEvent是一个 switch 分发器处理四类事件事件名处理函数职责route:addedonRouteAdded还原匹配器类型、解析 fixture构造BackendRoute并压入state.routessubscribesubscribe按requestId找到InterceptedRequest调用addSubscription追加订阅event:handler:resolvedInterceptedRequest.resolveEventHandler触发pendingEventHandlers[eventId]并携带changedData/stopPropagationsend:static:responsesendStaticResponse解析 fixture、发送静态响应若已进入响应阶段则标记includeBodyInAfterResponse其中onRouteAdded会先调用_restoreMatcherOptionsTypes把序列化的AnnotatedRouteMatcherOptions还原为真实类型type: regex的字段会从/aaa/igm形式的字符串重建new RegExp(pattern, flags)而https、port、middleware、times等普通字段则按PLAIN_FIELDS原样保留——这正是 driver-events.spec.ts 中rehydrates regexes properly用例验证的行为。订阅机制InterceptedRequest 与 handleSubscriptionslib/server/intercepted-request.ts 中的InterceptedRequest类是整个拦截生命周期的心脏。它持有req/res、socket、state以及三个关键回调continueRequest放行请求走后续代理步骤、_onResponse用响应结束当前请求、continueResponse把响应送过后续响应代理步骤。默认订阅规划当请求命中路由后addDefaultSubscriptions()调用packages/network-interception的planSubscriptions见 packages/network-interception/lib/core/plan-subscriptions.ts为每个匹配路由生成订阅计划一个before:request订阅await值取决于路由是否带拦截器 三个默认通知订阅response:callback、after:response、network:error均不 await。若请求是同步 XHR 且路由带拦截器则跳过拦截并发出SYNCHRONOUS_XHR_REQUEST_NOT_INTERCEPTED警告。订阅调度核心handleSubscriptions({ eventName, data, mergeChanges })是订阅执行的统一入口按匹配路由顺序、再按订阅定义顺序遍历subscriptionsByRoute跳过skip或事件名不匹配的订阅为每个订阅生成唯一eventId通过 socket 以net:stubbing:event事件把eventFrame含browserRequestId、requestId、data发给 driver若订阅await为真则把 resolve 挂入pendingEventHandlers等待 driver 回执拿到changedData后用mergeChanges合并回原数据支持stopPropagation短路一旦 driver 返回stopPropagation: true立即终止后续订阅乃至外层循环在before:request阶段还会处理immediateStaticResponse——若静态响应除log外还有其他键则直接sendStaticResponse并结束调度每次before:request命中都会递增route.matches当超过routeMatcher.times时禁用该路由实现times的“仅匹配前 N 次”语义。intercepted-request.spec.ts 的两个用例分别验证了“订阅按预期调度且toDriver恰好被调用两次”与“disabled 订阅被跳过、仅调用一次”。中间件四件套请求、响应、错误与路由匹配net-stubbing 以packages/proxy的中间件形态接入代理管道四个中间件全部在 lib/server/middleware/ 目录SetMatchingRoutes —— 请求前路由匹配export const SetMatchingRoutes: RequestMiddleware async function () { ... }对 dev server 公共路径的请求不做任何路由匹配直接next()防止用户拦截到 dev server 自身流量若matchesRoutePreflight判定存在匹配路由的 CORS 预检 OPTIONS 请求则直接返回 204 预检响应否则调用networkInterceptionCore.matchRoutes计算req.matchingRoutes无命中时输出 debug 日志。InterceptRequest —— 请求拦截编排export const InterceptRequest: RequestMiddleware async function () { return this.networkInterceptionCore.handleRequest((core) handleInterceptRequest(this, core)) }实际编排在 lib/server/handle-intercept-request.ts构造InterceptedRequest、存入state.requests、读取并规范化请求体用getBodyEncoding判断 utf8/binary、执行before:request订阅、把 driver 修改合并回真实请求最后视情况continueRequest()放行或end()终止。InterceptResponse —— 响应拦截编排export const InterceptResponse: ResponseMiddleware async function () { return this.networkInterceptionCore.interceptResponse(this) }底层handleInterceptResponselib/server/handle-intercept-response.ts读取上游响应体依次执行before:response、response:callback、response三类响应订阅用mergeWithPreservedBuffers与mergeDeletedHeaders合并改动最后按需延迟/限速后continueResponse送出。InterceptError —— 网络错误拦截export const InterceptError: ErrorMiddleware async function () { ... }若当前请求处于拦截状态则执行network:error订阅把克隆的错误对象发给 driver 处理后再继续。这四个中间件在 packages/proxy/lib/http/request-middleware.ts、response-middleware.ts 与 error-middleware.ts 中被注册进各自的中间件链proxy 单元测试如 packages/proxy/test/unit/http/request-middleware.spec.ts会对注册顺序与存在性做断言。响应工具链静态响应、fixture、延迟与限速lib/server/util.ts 承载了静态响应发送的全部细节sendStaticResponseforceNetworkError时构造带isForceNetworkError标记的错误并走onError否则以statusCode || 200、自定义 headers 与 body 生成一个伪造的IncomingMessage_getFakeClientResponse使其能像真实 HTTP 响应一样被后续响应中间件处理再经getBodyStream送出setResponseFromFixture解析 fixture 内容自动推断content-type按扩展名 mime 或parseContentType兜底并保持与cy.route的兼容行为null数据序列化为空字符串getBodyStream实现delay毫秒延迟与throttleKbps千字节/秒限速——延迟通过setTimeout实现限速通过ThrottleStream({ bps: throttleKbps * 1024 })管道实现二者时序由 util.spec.ts 的applies delay before throttling the body用例精确验证parseContentType用正则/JSON 解析推断application/json、text/html或默认text/plaingetBodyEncoding优先看content-type中的charsetutf-8否则用istextorbinary探测字节内容判断 utf8/binarysetDefaultHeaders为拦截响应补齐 CORS 相关头若用户设置自定义头则自动附加access-control-expose-headers: *。与整个拦截体系的协作位置net-stubbing 并非孤立存在。packages/network-interception是传输无关的拦截规则中心路由匹配、订阅规划、处理器合并、策略注册而 net-stubbing 提供其驱动的 I/O 与InterceptedRequest生命周期。两者通过端口-适配器ports and adapters模式解耦DriverInterceptRegistrationAdapter实现驱动端口ForInterceptRegistration而handleInterceptResponse则被 packages/proxy/lib/adapters/proxy-response-interception.ts 包装为受驱端口ForResponseInterception的适配器。Middleware 一律通过this.networkInterceptionCore.*调用核心再由核心路由到注入的端口实现保证匹配规则与字节传输方式彻底解耦。相关背景可继续阅读 packages/network-interception/README.md 与 packages/net-stubbing/lib/adapters/README.md。小结packages/net-stubbing以约 20 个源文件支撑起 Cypress 网络拦截的服务端半边NetStubbingState提供状态容器onNetStubbingEvent汇聚 driver 的注册与回执事件InterceptedRequest.handleSubscriptions完成订阅调度与数据合并四个中间件把拦截能力挂入代理管道util.ts则负责静态响应、fixture、延迟与限速等传输细节。开发者日常可通过yarn build-prod编译、yarn test运行 vitest 单元测试并借助 driver 侧的net_stubbing_spec获得端到端行为保障——理解这条链路也就理解了cy.intercept从“注册路由”到“改写响应”的完整后端旅程。赞分享测试质量保障前端接口测试【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址https://gitcode.com/GitHub_Trending/cy/cypress点击查看免费下载相关推荐黑苹果装机不折腾OpCore-Simplify 快速生成 OpenCore EFI 配置的完整指南黑苹果装机不折腾OpCore Simplify 快速生成 OpenCore EFI 配置的完整指南 装黑苹果最劝退的往往不是下载系统而是那份 config.开发工具CLI深入解析 Cypress Net Stubbing 服务端cy.intercept() 拦截管道的实现原理与源码导读深入解析 Cypress Net Stubbing 服务端cy.intercept 拦截管道的实现原理与源码导读 cy.intercept 是 Cypress测试质量保障前端接口测试Cypress 网络拦截适配层深度解析DriverInterceptRegistrationAdapter 与 net-stubbing 的六边形架构Cypress 网络拦截适配层深度解析DriverInterceptRegistrationAdapter 与 net stubbing 的六边形架构 Cyp测试质量保障前端接口测试上一篇TVM SDAccel HLS 后端实战在 AWS F1 FPGA 实例上编译与部署向量加法内核下一篇如何快速掌握GMM-TorchPyTorch高斯混合模型完整实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/10 5:37:03 · 阅读 1.2k Cypress net-stubbing 包源码深度解析：cy.intercept 服务端拦截引擎的架构、构建与测试
测试质量保障前端接口测试【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址https://gitcode.com/GitHub_Trending/cy/cypress点击查看免费下载导读packages/net-stubbing是 Cypress 中负责网络拦截network stubbing服务端实现的核心包它承载了cy.intercept()在后端代理层一侧的全部逻辑路由注册、请求/响应拦截、订阅调度与静态响应发送并对外导出供浏览器端driver消费的完整类型定义。阅读本文你将掌握该包在整个 monorepo 中的职责边界、InterceptedRequest订阅机制的底层原理、四类驱动事件的流转路径以及本地构建与单元测试的标准操作方式。包定位服务端实现 类型定义packages/net-stubbing/README.md 对该包的定位给出了明确说明本包包含 Cypress 网络拦截特性的服务端代码与类型定义驱动侧driver代码位于driver包中。服务端代码指运行在 Cypress 代理/运行时一侧的拦截逻辑包括路由匹配、订阅规划、请求响应流处理等全部位于lib/server/目录下类型定义cy.intercept对外暴露的公开 API 类型如RouteMatcher、StaticResponse、CyHttpMessages等并非在本包内手写而是由packages/network-interception包的lib/types/external-types.ts统一维护。构建时 cli/scripts/sync-typedefs.ts 会将该文件逐字复制为cli/types/net-stubbing.d.ts随 Cypress 发布给用户使用——这正是用户侧import cypress/types/net-stubbing的类型来源驱动侧driver浏览器内执行的cy.intercept命令实现位于packages/driver/src/cy/net-stubbing/其端到端行为验证位于 packages/driver/cypress/e2e/commands/net_stubbing.cy.ts。从依赖关系看本包的package.jsonpackages/net-stubbing/package.json声明了packages/network-interception、packages/socket两个内部运行时依赖以及debug、is-html、istextorbinary、lodash、mime、throttle等通用工具库并作为 devDependencies 引入packages/errors、packages/network、packages/proxy、packages/telemetry主入口main指向./lib/server。目录结构服务端核心与适配层packages/net-stubbing/ ├── lib/ │ ├── adapters/ │ │ ├── README.md # 端口/适配器说明 │ │ └── driver-intercept-registration.ts # 驱动事件注册适配器 │ └── server/ │ ├── middleware/ │ │ ├── error.ts # InterceptError 错误中间件 │ │ ├── request.ts # SetMatchingRoutes / InterceptRequest 请求中间件 │ │ └── response.ts # InterceptResponse 响应中间件 │ ├── driver-events.ts # onNetStubbingEvent 事件分发入口 │ ├── handle-intercept-request.ts # 请求拦截编排 │ ├── handle-intercept-response.ts # 响应拦截编排 │ ├── index.ts # 包对外导出 │ ├── intercepted-request.ts # InterceptedRequest 核心类 │ ├── state.ts # NetStubbingState 状态工厂 │ ├── types.ts # 状态类型定义 │ └── util.ts # 静态响应/流/编码工具 └── test/ └── unit/ ├── adapters/driver-intercept-registration.spec.ts ├── driver-events.spec.ts ├── intercepted-request.spec.ts └── util.spec.ts其中 lib/server/index.ts 是本包的对外出口导出了onNetStubbingEvent、DriverInterceptRegistrationAdapter、InterceptError、SetMatchingRoutes、InterceptRequest、InterceptResponse、handleInterceptResponse以及netStubbingState状态实例。这些导出分别被代理层proxy与运行时server所引用。构建开发期免构建生产期一条命令原文档强调开发阶段你通常不需要手动构建 .js 文件。packages/ts提供了 require 时的即时转译require-time transpilation开发时直接运行 TypeScript 源码即可。仅在需要产出编译产物时执行yarn build-prod该命令在 package.json 中实际定义为tsc --project .即使用包内 tsconfig.json继承自../ts/tsconfig.json覆盖lib/*.ts与lib/**/*.ts编译整个包的 TypeScript 源码。除build-prod外该包还提供check-tstsc --noEmit加 tslint 静态检查、lint、test-debugvitest --inspect-brk --no-file-parallelism --test-timeout0与test-watchvitest watch等开发命令。测试单元测试与驱动层行为验证原文档指出测试位于./test运行方式为yarn test对应的 package.json 中test脚本为vitest配置见 vitest.config.ts以 node 环境运行test/**/*.spec.ts下的全部用例并设置CYPRESS_INTERNAL_ENVtest环境变量。当前仓库包含四组单元测试test/unit/adapters/driver-intercept-registration.spec.ts验证适配器如何把route:added、subscribe、event:handler:resolved、send:static:response四类驱动事件转发到onNetStubbingEvent及对应状态test/unit/driver-events.spec.ts验证_restoreMatcherOptionsTypes能将type: regex的序列化匹配器还原为真正的RegExp实例含 flagstest/unit/intercepted-request.spec.ts验证handleSubscriptions对订阅的调度、对 disabled 订阅的跳过test/unit/util.spec.ts验证parseContentType的内容类型推断、getBodyEncoding的 utf8/binary 判定、getBodyStream的 delay 与 throttle 时序。此外原文档特别强调driver包中的net_stubbing_spec会测试本仓库的功能。对应文件即 packages/driver/cypress/e2e/commands/net_stubbing.cy.ts它以真实浏览器端到端的方式覆盖cy.intercept在 driver 与服务端协作下的完整行为是比单元测试更全面的行为级验证。核心状态NetStubbingStatelib/server/types.ts 定义了贯穿整个拦截生命周期的状态结构export interface NetStubbingState { pendingEventHandlers: { [eventId: string]: (opts: { changedData: any, stopPropagation: boolean }) void } requests: { [requestId: string]: InterceptedRequest } routes: BackendRoute[] reset: () void }routes已注册的BackendRoute数组由 driver 的cy.intercept()通过route:added事件写入requests按requestId索引的在途拦截请求供请求/响应/错误中间件按 ID 找回对应对象pendingEventHandlers等待 driver 回执的事件回调表——当订阅需要await时服务端先把 resolve 函数挂在这里driver 处理完成后通过event:handler:resolved事件触发回调reset()清理所有未完成请求移除监听、销毁响应、清空事件处理器与路由表用于测试间隔离。lib/server/state.ts 中state()工厂实现了上述结构并在reset()中显式执行res.removeAllListeners(finish/error)与res.destroy()避免残留请求污染后续测试。该状态实例通过index.ts以netStubbingState名称导出被packages/proxy注入到中间件上下文见 packages/proxy/lib/http/index.ts 中的netStubbingState字段。驱动事件入口onNetStubbingEvent 的四类分发driver 与 net-stubbing 服务端的通信经由 socket 完成。传统路径中socket 收到net事件后调用onNetStubbingEvent在新架构下lib/adapters/driver-intercept-registration.ts 中的DriverInterceptRegistrationAdapter实现了packages/network-interception的ForInterceptRegistration驱动端口把handleEvent(request)转发给同一个onNetStubbingEvent。其调用链为SocketBasedriver 的 net 事件 → ForInterceptRegistration.handleEvent() → DriverInterceptRegistrationAdapter → onNetStubbingEvent()lib/server/driver-events.ts 中的onNetStubbingEvent是一个 switch 分发器处理四类事件事件名处理函数职责route:addedonRouteAdded还原匹配器类型、解析 fixture构造BackendRoute并压入state.routessubscribesubscribe按requestId找到InterceptedRequest调用addSubscription追加订阅event:handler:resolvedInterceptedRequest.resolveEventHandler触发pendingEventHandlers[eventId]并携带changedData/stopPropagationsend:static:responsesendStaticResponse解析 fixture、发送静态响应若已进入响应阶段则标记includeBodyInAfterResponse其中onRouteAdded会先调用_restoreMatcherOptionsTypes把序列化的AnnotatedRouteMatcherOptions还原为真实类型type: regex的字段会从/aaa/igm形式的字符串重建new RegExp(pattern, flags)而https、port、middleware、times等普通字段则按PLAIN_FIELDS原样保留——这正是 driver-events.spec.ts 中rehydrates regexes properly用例验证的行为。订阅机制InterceptedRequest 与 handleSubscriptionslib/server/intercepted-request.ts 中的InterceptedRequest类是整个拦截生命周期的心脏。它持有req/res、socket、state以及三个关键回调continueRequest放行请求走后续代理步骤、_onResponse用响应结束当前请求、continueResponse把响应送过后续响应代理步骤。默认订阅规划当请求命中路由后addDefaultSubscriptions()调用packages/network-interception的planSubscriptions见 packages/network-interception/lib/core/plan-subscriptions.ts为每个匹配路由生成订阅计划一个before:request订阅await值取决于路由是否带拦截器 三个默认通知订阅response:callback、after:response、network:error均不 await。若请求是同步 XHR 且路由带拦截器则跳过拦截并发出SYNCHRONOUS_XHR_REQUEST_NOT_INTERCEPTED警告。订阅调度核心handleSubscriptions({ eventName, data, mergeChanges })是订阅执行的统一入口按匹配路由顺序、再按订阅定义顺序遍历subscriptionsByRoute跳过skip或事件名不匹配的订阅为每个订阅生成唯一eventId通过 socket 以net:stubbing:event事件把eventFrame含browserRequestId、requestId、data发给 driver若订阅await为真则把 resolve 挂入pendingEventHandlers等待 driver 回执拿到changedData后用mergeChanges合并回原数据支持stopPropagation短路一旦 driver 返回stopPropagation: true立即终止后续订阅乃至外层循环在before:request阶段还会处理immediateStaticResponse——若静态响应除log外还有其他键则直接sendStaticResponse并结束调度每次before:request命中都会递增route.matches当超过routeMatcher.times时禁用该路由实现times的“仅匹配前 N 次”语义。intercepted-request.spec.ts 的两个用例分别验证了“订阅按预期调度且toDriver恰好被调用两次”与“disabled 订阅被跳过、仅调用一次”。中间件四件套请求、响应、错误与路由匹配net-stubbing 以packages/proxy的中间件形态接入代理管道四个中间件全部在 lib/server/middleware/ 目录SetMatchingRoutes —— 请求前路由匹配export const SetMatchingRoutes: RequestMiddleware async function () { ... }对 dev server 公共路径的请求不做任何路由匹配直接next()防止用户拦截到 dev server 自身流量若matchesRoutePreflight判定存在匹配路由的 CORS 预检 OPTIONS 请求则直接返回 204 预检响应否则调用networkInterceptionCore.matchRoutes计算req.matchingRoutes无命中时输出 debug 日志。InterceptRequest —— 请求拦截编排export const InterceptRequest: RequestMiddleware async function () { return this.networkInterceptionCore.handleRequest((core) handleInterceptRequest(this, core)) }实际编排在 lib/server/handle-intercept-request.ts构造InterceptedRequest、存入state.requests、读取并规范化请求体用getBodyEncoding判断 utf8/binary、执行before:request订阅、把 driver 修改合并回真实请求最后视情况continueRequest()放行或end()终止。InterceptResponse —— 响应拦截编排export const InterceptResponse: ResponseMiddleware async function () { return this.networkInterceptionCore.interceptResponse(this) }底层handleInterceptResponselib/server/handle-intercept-response.ts读取上游响应体依次执行before:response、response:callback、response三类响应订阅用mergeWithPreservedBuffers与mergeDeletedHeaders合并改动最后按需延迟/限速后continueResponse送出。InterceptError —— 网络错误拦截export const InterceptError: ErrorMiddleware async function () { ... }若当前请求处于拦截状态则执行network:error订阅把克隆的错误对象发给 driver 处理后再继续。这四个中间件在 packages/proxy/lib/http/request-middleware.ts、response-middleware.ts 与 error-middleware.ts 中被注册进各自的中间件链proxy 单元测试如 packages/proxy/test/unit/http/request-middleware.spec.ts会对注册顺序与存在性做断言。响应工具链静态响应、fixture、延迟与限速lib/server/util.ts 承载了静态响应发送的全部细节sendStaticResponseforceNetworkError时构造带isForceNetworkError标记的错误并走onError否则以statusCode || 200、自定义 headers 与 body 生成一个伪造的IncomingMessage_getFakeClientResponse使其能像真实 HTTP 响应一样被后续响应中间件处理再经getBodyStream送出setResponseFromFixture解析 fixture 内容自动推断content-type按扩展名 mime 或parseContentType兜底并保持与cy.route的兼容行为null数据序列化为空字符串getBodyStream实现delay毫秒延迟与throttleKbps千字节/秒限速——延迟通过setTimeout实现限速通过ThrottleStream({ bps: throttleKbps * 1024 })管道实现二者时序由 util.spec.ts 的applies delay before throttling the body用例精确验证parseContentType用正则/JSON 解析推断application/json、text/html或默认text/plaingetBodyEncoding优先看content-type中的charsetutf-8否则用istextorbinary探测字节内容判断 utf8/binarysetDefaultHeaders为拦截响应补齐 CORS 相关头若用户设置自定义头则自动附加access-control-expose-headers: *。与整个拦截体系的协作位置net-stubbing 并非孤立存在。packages/network-interception是传输无关的拦截规则中心路由匹配、订阅规划、处理器合并、策略注册而 net-stubbing 提供其驱动的 I/O 与InterceptedRequest生命周期。两者通过端口-适配器ports and adapters模式解耦DriverInterceptRegistrationAdapter实现驱动端口ForInterceptRegistration而handleInterceptResponse则被 packages/proxy/lib/adapters/proxy-response-interception.ts 包装为受驱端口ForResponseInterception的适配器。Middleware 一律通过this.networkInterceptionCore.*调用核心再由核心路由到注入的端口实现保证匹配规则与字节传输方式彻底解耦。相关背景可继续阅读 packages/network-interception/README.md 与 packages/net-stubbing/lib/adapters/README.md。小结packages/net-stubbing以约 20 个源文件支撑起 Cypress 网络拦截的服务端半边NetStubbingState提供状态容器onNetStubbingEvent汇聚 driver 的注册与回执事件InterceptedRequest.handleSubscriptions完成订阅调度与数据合并四个中间件把拦截能力挂入代理管道util.ts则负责静态响应、fixture、延迟与限速等传输细节。开发者日常可通过yarn build-prod编译、yarn test运行 vitest 单元测试并借助 driver 侧的net_stubbing_spec获得端到端行为保障——理解这条链路也就理解了cy.intercept从“注册路由”到“改写响应”的完整后端旅程。赞分享测试质量保障前端接口测试【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址https://gitcode.com/GitHub_Trending/cy/cypress点击查看免费下载相关推荐黑苹果装机不折腾OpCore-Simplify 快速生成 OpenCore EFI 配置的完整指南黑苹果装机不折腾OpCore Simplify 快速生成 OpenCore EFI 配置的完整指南 装黑苹果最劝退的往往不是下载系统而是那份 config.开发工具CLI深入解析 Cypress Net Stubbing 服务端cy.intercept() 拦截管道的实现原理与源码导读深入解析 Cypress Net Stubbing 服务端cy.intercept 拦截管道的实现原理与源码导读 cy.intercept 是 Cypress测试质量保障前端接口测试Cypress 网络拦截适配层深度解析DriverInterceptRegistrationAdapter 与 net-stubbing 的六边形架构Cypress 网络拦截适配层深度解析DriverInterceptRegistrationAdapter 与 net stubbing 的六边形架构 Cyp测试质量保障前端接口测试上一篇TVM SDAccel HLS 后端实战在 AWS F1 FPGA 实例上编译与部署向量加法内核下一篇如何快速掌握GMM-TorchPyTorch高斯混合模型完整实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考