用途:cypress tap 控制一个已经运行的 cypress open 会话,用于迭代规格、检查报告器和命令日志,并读取被测应用,无需 GUI 交互。一次性无头批处理应改用 cypress run。
前提条件:解析后的 Cypress 须为 15.21.0+ 并包含 tap;不支持 Firefox 与 WebKit;cypress open 及配置的 baseUrl 开发服务器须已启动;cwd 决定 Cypress 二进制和自动选中的会话,若目标项目固定旧版 Cypress,应从兼容 checkout 运行并每次传入 --session <pid>。
主要命令:sessions(可达会话与项目根)、status(生命周期阶段、所选规格、运行标识、计数、构建错误)、specs(可运行规格路径)、run <spec>(派发规格并立即返回)、reporter(含 --test-id 查看完整测试尝试)、command(一条命令日志行)、pin(回退应用帧到命令快照)、dom/aria/inspect(读取已稳定应用或固定快照)。所有命令支持 --session、--json、--timeout。
判定规则:run 只确认派发而非执行,返回早于新运行开始;须轮询 status --json,仅接受预期规格的 passed/failed 且 startedAt 非空且变化的结果,并限制轮询次数。保存规格会触发 watcher 自动运行,不要同时有两个运行。status 退出码非零属于命令失败,应停止轮询并上报。仅 passed 与 failed 是判定,构建失败体现为 failed 且诊断在 status.error 中。
使用限制:reporter/command 的 JSON 可能达数百 KB,应重定向到文件再解析;dom 与 aria 输出有截断上限,出现 (output truncated) 时需缩小选择器或提高上限;dom/aria/inspect 要求恰好一个选中元素,歧义时退出 1;结果与快照存于内存,重跑、重启、重命名或删除会丢失;检查快照后须执行 pin --clear。失败信息为散文式、无稳定错误码,需按退出状态分支。其他细节以官方文档为准。