webapp-testing：用 Playwright 测本地 Web 应用

适合谁

当你要用 Playwright 与本地 Web 应用交互并做测试时，使用 webapp-testing。它支持核验前端功能、调试界面行为、抓浏览器截图，以及查看浏览器日志。对象是本地应用，不是未点名的远程站点扫描。

更合适的前提是：你准备写原生 Python Playwright 脚本，并用辅助脚本管理服务器生命周期。资料没有给出代理产品名单或安装器，不要编造仓库路径。官方说明页是

https://raw.githubusercontent.com/anthropics/skills/main/skills/webapp-testing/SKILL.md

3 分钟完成第一次尝试

推荐的第一条路径是先看辅助脚本用法，而不是先开浏览器。资料点名 scripts/with_server.py 负责管理服务器生命周期（支持多服务器），并要求：Always run scripts with --help first。

前置：当前环境能运行该 helper。低风险第一次：

scripts/with_server.py --help

成功信号：打印出用法，服务器尚未被拉起。这是只读帮助。不要先读 helper 源码来猜参数——摘要写明先 --help，而不是先读源。

若帮助能看懂，并且你确认要测一个本地应用，再写 Playwright 脚本。必须用 sync_playwright，并以 headless 启动 chromium：browser = p.chromium.launch(headless=True)。启动服务器和打开页面都会改环境、也可能写日志，先确认目标就是你的本地应用，再执行。摘要提到 helper 启动后再对着 localhost 测，但摘录没有写出端口号，因此不要编造地址。

使用案例

案例一：用 helper 带着本地服务器跑一次只读查看。先 --help，确认参数后再调用 scripts/with_server.py。脚本里用 sync_playwright 打开 headless chromium。完成标准是浏览器在无头模式启动，并且你还没有对页面执行破坏性操作。资料支持截图和看日志，这两项相对可逆；写文件前先确认截图落盘路径。

案例二：动态应用按「先侦察再操作」。顺序是：导航并等待 networkidle；截图或检查 DOM；从渲染结果识别选择器；再用发现的选择器执行操作。资料明确不要在动态应用上、在等到 networkidle 之前就检查 DOM；正确做法是等待 page.wait_for_load_state('networkidle') 后再检查。完成标准是你能指出等待发生在检查之前。不要在未等到网络空闲时点击未确认的选择器。

使用边界

只覆盖本地 Web 应用的 Playwright 测试。chromium 始终 headless。helper 先 --help。动态应用必须先 networkidle 再看 DOM。

不要编造安装器、仓库路径或未写出的 localhost 端口。资料没有给出客户端名单，也没有写如何对非本地站点使用。超出这些已写明的 helper、无头启动和侦察顺序，这份说明覆盖不到。