Puppeteer 中文文档v25.8.0

Page.goto() 方法

将框架或页面导航到给定的 url

签名

class Page {
  goto(url: string, options?: GoToOptions): Promise<HTTPResponse | null>;
}

参数

参数

类型

说明

url

string

要导航到的框架的 URL。URL 应包含协议(scheme),例如 https://

options

GoToOptions

(可选) 用于配置等待行为的选项。

返回值:

Promise<HTTPResponse | null>

解析为主资源响应的 promise。如果存在多次重定向,导航将以最后一次重定向的响应解析。

备注

导航到 about:blank 或导航到具有不同 hash 的相同 URL 将成功并返回 null

⚠️警告

无头 shell 模式不支持导航到 PDF 文档。请参阅上游 issue

在无头 shell 中,当远程服务器返回任何有效的 HTTP 状态码(包括 404 "Not Found" 和 500 "Internal Server Error")时,此方法不会抛出错误。此类响应的状态码可通过调用 HTTPResponse.status() 获取。