调试#

使用调试命令在自动化过程中检查浏览器日志、页面错误、JavaScript 对话框、Chrome DevTools 跟踪、高亮元素以及实时 DevTools 前端。

控制台与页面错误#

bash

agent-browser console
agent-browser console --json
agent-browser console --clear

agent-browser errors
agent-browser errors --clear

命令	描述
`console`	显示浏览器控制台消息
`console --json`	显示带原始 CDP 参数的结构化控制台输出
`console --clear`	清除 agent-browser 捕获的控制台日志
`errors`	显示捕获到的页面错误和未捕获的 JavaScript 异常
`errors --clear`	清除捕获到的页面错误日志

当对象预览或原始 CDP 参数对自动化诊断脚本很重要时，使用 console --json。当代理只需要理解页面记录了什么时，使用默认的文本输出。

bash

agent-browser dialog status
agent-browser dialog accept
agent-browser dialog accept "prompt text"
agent-browser dialog dismiss

默认情况下，alert 和 beforeunload 对话框会自动接受，因此不会阻塞代理。confirm 和 prompt 仍然需要显式处理。可使用 --no-auto-dialog 或 AGENT_BROWSER_NO_AUTO_DIALOG=1 关闭自动处理。

当有对话框挂起时，命令响应会包含一个 warning 字段，标明对话框类型和消息，方便代理通过 dialog accept 或 dialog dismiss 恢复。

bash

agent-browser highlight @e4
agent-browser highlight "#submit"
agent-browser inspect

highlight 会在实时页面中突出显示某个元素，这在有头运行或通过流式传输/仪表盘查看会话时非常有用。inspect 会通过本地代理为当前页面打开 Chrome DevTools，同时守护进程继续接受 agent-browser 命令。

bash

agent-browser trace start

agent-browser open https://example.com
agent-browser click @e3

agent-browser trace stop ./trace.json

trace start 会开始一段 Chrome DevTools 跟踪。trace stop [path] 会结束跟踪并保存一个 Chrome Trace Event JSON 文件。如果未提供路径，agent-browser 会在其临时目录下写入一个自动生成的跟踪文件。

当你需要整理后的性能分类和事件计数时，使用性能分析器。当你需要用于底层调试的通用 Chrome 跟踪时，使用原始 trace。