index.mjs 是唯一可执行清单;一份用例一个模块,按主要验证目的归类。用 --list 查看实际 ID、目的和文件路径;已覆盖的条件与缺口见 覆盖清单。下表用于选择相关范围,交互动作仍放在所属功能目录。
| 目录 | 主要覆盖 |
|---|---|
table、header、cells |
列表基础、表头层级、单元格类型与格式 |
pivot、pivot-chart |
透视维度、虚拟节点、透视图 |
gantt、sheet、plugins |
扩展包的图形与 API |
layout、frozen、scroll、empty、theme |
尺寸、冻结、滚动、空状态、主题 |
interaction、keyboard、edit、sort、menu |
选择、编辑、排序 |
analysis、records、transpose |
聚合、过滤、记录更新、转置 |
components、custom、language、tree、data、group、style、api |
标题、自定义布局、多语言 |
新增用例先查找已有近邻,优先在一个明确场景中补强必要条件。模块默认导出 mount(container)、verify(page) 和可选 exercise(page);mount 返回待测实例。输入必须固定、公开、无外网依赖。exercise 需要执行真实动作,verify 需要检查目标状态;截图负责外观,不能替代语义断言。模块和核心方法写中文目的注释。登记唯一短 ID、目的、文件及所需 bundles;未登记模块不会执行。
只有与已确认存在的 BugServer 真实 case 对应的模块才在头部写 BugServer case IDs: <真实ID>;合并时列出全部真实来源 ID,改写时仍保留原 ID。开发者或编码 Agent 独立新增的本地用例完全省略这一行,不填空值、占位或虚构 ID;管理员手动创建 BugServer 用例成功后才补写服务返回的真实 ID。该 ID 只用于追溯,不表示与线上内容实时同步。
从 BugServer 迁移来源时,缺少 interactions 字段仅表示没有附加录制动作;仍须检查源码中的事件、定时器、异步调用、后续 API 更新及资源。保留目标配置、数据边界、动作顺序和最终状态。不得复制业务原文、内部地址、凭证、原始数据或截图到公开仓库;来源不明时先在仓库外私有目录复核。
新增或修改后先运行单例 --self-compare --case <id>,再运行对应目录;提交前运行默认全量比较。若用例在官方基线不支持,报告为执行错误,应如实说明,不能把自比较当作双侧通过。
新增平台用例的完整步骤见BugServer case 流程。只有对应项目管理员可新增;外部开发者提供材料,由管理员代建。 手动创建成功后才能回填真实 ID;本地用例与平台不会自动同步。
需要确认旧版业务断言失败时,仅在明确的状态比较失败处 throw assertionError(原错误消息),使用 assertions.mjs 的显式错误类型;浏览器端可在 page.evaluate(async () => { ... }) 内从 /suite/assertions.mjs 动态导入。不要捕获整段浏览器/API 异常再统一包装。普通 Error 继续使测试失败,但不再仅凭所在阶段获准转成 new_baseline。