用途:通过 Playwriter CLI 驱动用户当前活动的 Chrome 标签页,而不是新开浏览器,适合检查实时 UI 状态、执行脚本化操作和读取页面数据。
主要能力:可确认连接与目标标签页(读取 URL、标题)、采集页面结构(accessibilitySnapshot)、执行点击/输入/悬停/请求/求值等定向操作,并通过 page.evaluate 拉取日志与结构化状态。
使用方式:先确保目标标签页上的 Playwriter 扩展已启用(绿色),确认 CLI 可用:playwriter --version || npx -y playwriter --version;创建或附加会话:playwriter session new;再对会话执行命令,例如 playwriter -s 1 -e "console.log(await page.url())"。常用命令包括用 getByRole 获取列表项、悬停读取弹层内容、在页面内运行调试代码等。
适用场景:需要在不新开浏览器的前提下检查或操作当前页面,例如读取应用 UI 选项、抓取悬停提示、收集页面日志与状态变化。
限制与注意事项:若会话附加到错误标签页,需在目标标签页点击扩展图标后重新运行 playwriter session new;命令缺失时可用 npx -y playwriter ... 或全局安装;连接过期时新建会话。除任务需要变更外优先只读检查,执行破坏性 UI 操作前应先声明,汇总日志时需对敏感令牌和用户数据脱敏。完整文档见 https://playwriter.dev/。