跳至主要内容
版本: 22.5.0

Frame.goto() 方法

将框架导航到给定的 url

签名:

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

参数

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

返回值

Promise<HTTPResponse | null>

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

异常

如果

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

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

备注

导航到 about:blank 或使用不同哈希值导航到同一 URL 将成功并返回 null

警告

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