Playwright Testing (MiniPC) 是一个利用 MiniPC 上安装的 Playwright 来测试网页应用和游戏的技能。
用途:用于验证前端功能、调试 UI 行为、捕获截图,以及进行游戏 QA 和网页应用功能测试。
运行环境:执行位置为 MiniPC(通过 nodes.run 或 browser.proxy);浏览器为 Chromium headless。
判断逻辑:先判断测试对象是否为静态 HTML。若为静态 HTML,则直接读取文件内容以确定选择器,再用 Playwright 脚本自动化;若为动态网页应用,则先确认服务器是否运行,若未运行则需先在 MiniPC 上启动服务器,然后在已运行时采用“侦察—行动”模式:1. 页面导航并等待 networkidle;2. 截图或检查 DOM;3. 确定选择器;4. 执行操作。
核心模式为“侦察—行动”(Reconnaissance-Then-Action),示例使用 playwright.sync_api,启动 Chromium headless,新建页面,访问 http://localhost:PORT,并调用 page.wait_for_load_state('networkidle')(资料中标注为必需),随后截图、查找按钮、点击“Start Game”等操作。
游戏 QA 测试示例包括:访问 http://localhost:9877/game.html,等待 networkidle,确认 canvas 可见,在 canvas 坐标 (400, 300) 点击,等待 1000 毫秒,读取 #score 文本,截图到 /tmp/game-test.png,并通过 page.on('console', ...) 捕获错误。
注意事項:必须首先等待 networkidle,动态应用需在 JS 执行完成后检查 DOM;必须使用 headless=True(MiniPC 无显示器);必须在 MiniPC 上执行,禁止在 Mac Studio 上直接使用浏览器;仅代码审查不足以完成 QA,必须进行实际游玩测试;可使用 browser.proxy 或 nodes.run。
Clawdbot 中执行方法:方法一,使用 browser 工具(proxy),执行 browser action=navigate target=node node=MiniPC targetUrl="http://localhost:9877/game.html",然后 browser action=screenshot target=node node=MiniPC;方法二,使用 nodes.run 在 MiniPC 上运行 Python 脚本,命令为 nodes.run node=MiniPC command=["python3", "test_script.py"]。