SuperAPI AI 工具集

web-debugging

编程与开发

查看项目

更新于 10-16 09:24

技能介绍

Web Debugging Skill 是一个面向 Web 应用调试的技能,核心目标是通过检查控制台日志、网络请求与 JavaScript 错误,并结合非阻塞的 tracepoint/logpoint 等探针机制,帮助定位和排查前端问题。

用途 当页面出现 bug 或错误、需要调试 JavaScript 问题、检查 API 调用或网络请求、排查页面加载问题、处理控制台错误或警告,或希望在不暂停执行的情况下追踪代码执行时,该技能会被激活。

主要能力 控制台检查:获取全部控制台消息(o11y_get-console-messages),按日志级别(error、warn、info、debug)过滤,识别 JavaScript 异常与堆栈信息。

网络分析:监控 HTTP 请求(o11y_get-http-requests),检查请求/响应头,查看响应状态码与耗时,识别失败或缓慢的请求。

JavaScript 调试:在页面中执行诊断代码,使用 execute 与 page.evaluate()(例如 return await page.evaluate(() => document.querySelectorAll('script').length));检查 DOM 状态与元素属性;查看 localStorage、sessionStorage、cookies;验证 JavaScript 变量与状态。

非阻塞调试(进阶):Tracepoint(debug_put-tracepoint)可在特定代码位置捕获调用栈与局部变量而不暂停执行;Logpoint(debug_put-logpoint)在代码位置评估并记录表达式;Exceptionpoint(debug_put-exceptionpoint)在异常发生时捕获快照;Watch 表达式(debug_add-watch)在每次 tracepoint 命中时评估表达式;通过 debug_get-probe-snapshots 获取快照(类型包括 tracepoint、logpoint、exceptionpoint,返回 tracepointSnapshots、logpointSnapshots、exceptionpointSnapshots)。

错误调查:使用 ARIA 快照查看页面结构——导航后 go-to/go-back-or-forward/reload 默认返回 refs,否则调用 a11y_take-aria-snapshot;随后截图进行可视化验证;需要带标注的元素时使用标注截图(content_take-screenshot 配合 annotate: true);还可进行 HTML 快照并检查 404。

使用方式(调试工作流)

  1. 复现:导航到有问题的页面;2. ARIA 快照:获取页面结构与 refs;3. 捕获:截图(如需识别元素可标注);4. 检查控制台:查看 JavaScript 错误;5. 分析网络:查找失败请求;6. 设置探针:必要时添加 tracepoint/logpoint 以深入调查;7. 调查:运行诊断 JavaScript 或触发探针;8. 收集快照:获取捕获的调试快照;9. 记录:用证据总结发现。

最佳实践 始终先检查控制台错误;将网络请求过滤到相关端点;在操作前后截图;使用 tracepoint 在不停止执行的情况下检查调用栈;使用 logpoint 在特定代码点进行轻量日志记录;清晰记录复现步骤。

适用场景与限制 适用于 Web 前端页面的调试与排查。针对 Node.js 后端调试,可使用 PLATFORM=node 并参考 node-debugging 技能;Node 平台新增 debug_get-logs,且批量工具调用使用 execute(Node 上无 page)。其它关于收费、价格、平台支持范围等信息资料未提供。