📦 Clawbrowser — 浏览器

技能文档

 

Setup & orientation

• Install CLI 和 验证 availability:

   npm install -g @playwright/cli@latest
   playwright-cli --help
   

• CLI reads playwright-cli.json 由 默认 或 whatever file 您 pass 带有 --配置. 使用 配置 到 tune browser name, launch/context options, viewport, timeouts, 输出 directories, 和 recording settings 没有 changing every command.
• Keep playwright-cli --help terminal-accessible; script self-documents latest commands 和 options 所以 您 可以 刷新 memory 之前 trying 新的 action.

Core interaction 循环

• 开始 带有 playwright-cli 打开 到 加载 page (添加 --会话=name 如果 您 want isolation up front).
• Run playwright-cli snapshot 到 generate 元素 refs (e1, e2, …) 之前 任何 interaction. Always re-snapshot 之后 DOM changes 或 导航 到 avoid stale refs.
• 使用 refs 对于 actions:

• Capture 输出 evidence 带有 screenshot [ref], pdf, console [level], 或 network 到 prove flow 或 inspect errors.
• 示例 flow:

   playwright-cli open https://example.com/login
   playwright-cli snapshot
   playwright-cli fill e1 "user@example.com"
   playwright-cli fill e2 "supersecret"
   playwright-cli click e3
   playwright-cli snapshot
   playwright-cli screenshot
   

Sessions & persistence

• 使用 --会话= 到 keep cookies, storage, 和 tabs isolated per workflow. Sessions behave 点赞 persistent profiles: 它们 remember auth state, history, 和 tabs 之间 commands.
• 导出 PLAYWRIGHT_CLI_SESSION=mysession 如果 您 running many commands 在...中 相同 会话 — CLI 将 默认 到 会话 没有 needing --会话 每个 时间.
• Manage sessions explicitly:

  playwright-cli session-list
  playwright-cli session-stop 
  playwright-cli session-stop-all
  playwright-cli session-restart 
  playwright-cli session-delete 
  

• 使用 playwright-cli --isolated 打开 ... 对于 ephemeral contexts 做 不 persist 到 disk.
• Whenever 您 更改 browser settings 对于 会话 (launch args, headless 切换, browser selection), rerun playwright-cli 配置 对于 会话 和 然后 会话-restart 到 apply 新的 配置.

Tabs, 导航, 和 devtools

• 标签页 helpers: 标签页-列表, 标签页-新的 [url], 标签页-关闭 <索引>, 标签页-select <索引>.
• 导航 shortcuts: go-back, go-转发, 重新加载.
• Keyboard 和 mouse control: press <键>, keydown, keyup, mousemove , mousedown [按钮], mouseup [按钮], mousewheel .
• Devtools-样式 introspection:

  playwright-cli console [level]
  playwright-cli network
  playwright-cli run-code "async page => await page.context().grantPermissions(['clipboard-read'])"
  

Recording, tracing, 和 exports

• 记录 traces 和 videos 周围 delicate interactions 所以 您 可以 replay 什么 agent 做过 later:

  playwright-cli tracing-start
  # perform steps
  playwright-cli tracing-stop
  playwright-cli video-start
  # perform steps
  playwright-cli video-stop video.webm
  

• 保存 evidence 到 disk 带有 screenshot, pdf, 或 snapshot (哪个 dumps 元素 refs). Recorded files honor outputDir 从 配置.

配置, state, 和 housekeeping

• 使用 playwright-cli 配置 到 tweak runtime flags 没有 reinstalling. Examples:

  playwright-cli config --headed --browser=firefox
  playwright-cli --session=auth config --config=playwright-cli.json
  

• Running playwright-cli install refreshes browser binaries 如果 environment 新的 或 您 接收 errors 关于 missing binaries.
• Clean up sessions 当...时 finished 到 avoid stale state:

  playwright-cli session-stop 
  playwright-cli session-delete 
  

Troubleshooting & reminders

• 如果 command fails, rerun playwright-cli snapshot 到 confirm refs 仍然 有效. Snapshots provide current DOM context 对于 click/类型 operations.
• playwright-cli --help always shows latest command 设置, 所以 consult 之前 trying rarely used 标志.
• 当...时 agent needs 到 replicate recorded manual flow, capture screenshot, note 会话 name, 和 mention 哪个 refs 和 tabs 是 在...中 使用.
• 如果 targeting visible browser 必填 (e.g., manual inspection), reconfigure 带有 --headed, 或 run playwright-cli 打开 --headed 对于 会话 仅.