浏览器自动化控制

技能简介

Playwriter 是一个命令行工具，允许你在本地 Chrome 浏览器中运行 Playwright Page 脚本。它通过 Chrome 扩展建立持久连接，保留登录状态、Cookie 和扩展数据，适合需要认证信息的网页测试场景。

业务背景

解决传统自动化工具每次重启丢失登录态的痛点，直接复用本地 Chrome 的会话数据。特别适合需要频繁验证后台系统、SaaS 管理面板等强认证场景的业务人员，跳过繁琐的账号密码输入环节，大幅提升高频测试任务的人效。

落地案例：某企业财务专员每日需核对多个银行账户流水，各平台均需短信验证码登录。通过 Playwriter 建立持久 Chrome 会话后，直接执行脚本抓取 dashboard 数据，无需重复认证；客服主管定期抽检工单系统 SLA 达标情况，利用已登录状态快速截图留存审计证据，避免多人共用账号的安全风险。

能做什么

• 对已登录的网页仪表板进行 UI 验证
• 免重复登录即可访问需要认证的页面
• 测试依赖浏览器扩展或保存状态的流程
• 生成带无障碍标签的截图以辅助元素定位
• 拦截和修改网络请求响应

使用说明

安装步骤

1. 安装 CLI 工具：npm i -g playwriter
2. 按 Playwriter 仓库说明安装 Chrome 扩展
3. 启动 Chrome 并启用该扩展

基本操作

1. 创建新会话：playwriter session new
2. 查看并复制会话 ID：playwriter session list
3. 执行 Playwright 代码：playwriter -s <session_id> -e "await page.goto('https://example.com')"

可用变量：在 -e 参数中可直接使用 page（Page 对象）、context（BrowserContext）、state（跨调用持久化的对象）、require（加载模块）。

状态持久化示例：

playwriter -s <session_id> -e "state.lastUrl = page.url()"
playwriter -s <session_id> -e "console.log(state.lastUrl)"

输入与输出

见下方输入与输出表格。

风险提示

• 需手动安装 Chrome 扩展，配置步骤较多
• 会话状态混乱时需手动重置或关闭
• 直接执行字符串代码存在注入风险，避免传入不可信内容
• 依赖本地 Chrome 运行环境，无法在无 GUI 服务器直接使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/paulpete/playwriter/SKILL.md
来源类型：GitHub 仓库