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 文档。请参阅 上游问题。