TokenCap
通过解析 JSX AST 提取前端测试定位属性(data-testid、ARIA 角色、aria-label、htmlFor/id 配对)并生成索引快照供 AI 编码代理使用的工具,旨在解决代理生成测试时猜测 DOM 选择器导致的幻觉问题
时间轴 (近 90 天)
TokenCap 通过解析 JSX AST 节点提取显式测试属性(data-testid、role、aria-* 等)并集中索引,将 AI 代理定位元素的方式从猜测变为查询。
TokenCap 在 src/frontend/testIds.js 中定义并提取四类属性:data-testid/data-test/data-cy、role、aria-label/aria-labelledby/aria-describedby、htmlFor 与 input id 的配对关系。
TokenCap 通过 `tokencap make` 命令生成组件快照,快照中包含每个定位器对应的 Playwright 风格(getByTestId/getByRole)定位方式及源码行号。
把 ARIA 属性和测试标识符放在同一索引中,可引导 AI 代理在生成测试时使用无障碍最佳实践定位器,间接提升组件可访问性。
若前端本身定位属性混乱(data-testid 命名不规范、ARIA 填写不完整),索引也只能如实反映混乱,无法自动修复可测试性。
相比让 AI 代理读取整个 DOM 树或渲染后的 HTML,基于 AST 的索引方式 token 消耗可控且准确率更高。
对于已经在用 AI 代理写测试的团队,把测试定位属性纳入前端索引是投入产出比很高的改动。
全部知识事实 (7)
把 ARIA 属性和测试标识符放在同一索引中,可引导 AI 代理在生成测试时使用无障碍最佳实践定位器,间接提升组件可访问性。
50%待验证TokenCap 在 src/frontend/testIds.js 中定义并提取四类属性:data-testid/data-test/data-cy、role、aria-label/aria-labelledby/aria-describedby、htmlFor 与 input id 的配对关系。
50%待验证对于已经在用 AI 代理写测试的团队,把测试定位属性纳入前端索引是投入产出比很高的改动。
50%待验证TokenCap 通过解析 JSX AST 节点提取显式测试属性(data-testid、role、aria-* 等)并集中索引,将 AI 代理定位元素的方式从猜测变为查询。
50%待验证若前端本身定位属性混乱(data-testid 命名不规范、ARIA 填写不完整),索引也只能如实反映混乱,无法自动修复可测试性。
50%待验证相比让 AI 代理读取整个 DOM 树或渲染后的 HTML,基于 AST 的索引方式 token 消耗可控且准确率更高。
50%待验证TokenCap 通过 `tokencap make` 命令生成组件快照,快照中包含每个定位器对应的 Playwright 风格(getByTestId/getByRole)定位方式及源码行号。
50%