SuperAPI AI 工具集

extension-real-browser-testing

测试与质量

查看项目

更新于 10-16 06:20

技能介绍

用途:当需要在真实浏览器中验证扩展行为,而非依赖单元测试、jsdom 或静态截图时使用。适用于仅在构建、打包或未打包安装后才复现的缺陷,浏览器或版本特有问题,需要检查内容脚本 DOM、Shadow DOM、弹窗状态或 Service Worker 目标,以及 UI PR 需要真实行为截图时。

主要能力:提供真实浏览器验证流程,包括构建待测产物、确认输出目录与 manifest、搭建最小本地复现页、以全新配置文件加载未打包扩展、验证扩展确实加载、触发真实扩展流程、检查 DOM 与运行时状态,最后采集截图并清理临时环境。

使用方式:优先从 .output/<browser>-mv3 或等价构建目录加载未打包扩展;每次自动化使用全新配置文件;在 macOS 环境中 Edge 配合本地 Playwright 的 launchPersistentContext 较可靠。可从真实弹窗页读取 chrome.storage.local,并通过 chrome.runtime.sendMessage 触发与生产一致的消息。read-frog 页面翻译流程中,可等待 .read-frog-spinner 节点产生加载证据,再等待 .read-frog-translated-content-wrapper 含中文文本证明翻译完成。

适用场景:扩展真实行为验证、浏览器特定缺陷复现、内容脚本与弹窗调试、UI PR 截图证据。

限制:仅凭节点存在不足以证明状态,浮层可能在已关闭时仍挂载,需检查视觉状态;不要把一个浏览器的结论推广到所有浏览器;截图应保留原始前后对比,拼接图必须标注为合成图;测试应针对与用户报告一致的构建产物。