跳转到内容
搜索文档

Quick Actions 超时

最后更新 查看 MarkdownAgent 设置

Browser Run 使用多个独立计时器来管理请求各部分允许花费的时间。如果任一计时器超过其限制,请求将返回超时错误。

每个计时器控制渲染生命周期的特定部分——从页面加载、到选择器加载、再到操作。

计时器 范围 默认值 最大值
goToOptions.timeout 超时前等待页面加载的时间。 30 秒 60 秒
goToOptions.waitUntil 确定页面加载何时完成。详情请参阅 waitUntil 选项 domcontentloaded
waitForSelector 等待页面上出现特定元素(任意 CSS 选择器)的时间。 null 60 秒
waitForTimeout 页面加载完成后、继续执行操作前额外等待的时间。 null 60 秒
actionTimeout 页面加载后等待操作本身(例如:屏幕截图、PDF 或抓取)完成的时间。 null 5 分钟
PDFOptions.timeout actionTimeout 相同,但仅适用于 /pdf 端点 30 秒 5 分钟

waitUntil 选项

goToOptions.waitUntil 参数控制浏览器何时认为页面导航完成。这对于 JavaScript 密集型页面很重要,因为内容会在初始页面加载后动态渲染。

行为
load 等待 load 事件,包括所有资源如图片和样式表
domcontentloaded 等待 DOM 内容完全加载,在 load 事件之前触发(默认)
networkidle0 等待至少 500 毫秒内没有网络连接
networkidle2 等待至少 500 毫秒内不超过两个网络连接

对于依赖 JavaScript 渲染内容的页面,使用 networkidle0networkidle2 以确保页面在提取前完全渲染。

说明与建议

你可以设置多个计时器——只要其中一个完成,请求就会执行。

如果未获得预期输出:

  • 尝试增大 goToOptions.timeout(最高 60 秒)。
  • 如果等待特定元素,使用 waitForSelector。否则,将 goToOptions.waitUntil 设置为 networkidle2,确保页面已完成动态内容加载。
  • 如果收到 422,可能是操作本身(例如:截取屏幕截图、提取 HTML 内容)耗时较长。尝试增大 actionTimeout

这篇文档对您有帮助吗?