跳至主要内容
版本: 22.5.0

Page.goto() 方法

将页面导航到给定的 url

签名:

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

参数

参数类型描述
url字符串要导航页面的 URL。URL 应包含方案,例如 https://
optionsGoToOptions(可选) 配置等待行为的选项。

返回值

Promise<HTTPResponse | null>

一个 promise,它解析为主要资源响应。如果有多个重定向,导航将解析为最后一个重定向的响应。

异常

如果

  • 存在 SSL 错误(例如,在自签名证书的情况下)。 - 目标 URL 无效。 - 在导航过程中超时。 - 远程服务器没有响应或无法访问。 - 主要资源加载失败。

当远程服务器返回任何有效的 HTTP 状态代码时,此方法不会抛出错误,包括 404“未找到”和 500“内部服务器错误”。可以通过调用 HTTPResponse.status() 来检索此类响应的状态代码。

备注

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

警告

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

page.mainFrame().goto(url, options) 的快捷方式。