Frame.goto() 方法
将框架或页面导航到给定的 url。
签名
class Frame {
abstract goto(
url: string,
options?: GoToOptions,
): Promise<HTTPResponse | null>;
}
参数
|
参数 |
类型 |
说明 |
|---|---|---|
|
url |
string |
要将框架导航到的 URL。URL 应包含协议，例如 |
|
options |
(可选) 用于配置等待行为的选项。 |
返回值：
Promise<HTTPResponse | null>
一个解析为主资源响应的 Promise。如果发生多次重定向，导航将使用最后一次重定向的响应进行解析。
异常
如果出现以下情况：
-
存在 SSL 错误（例如自签名证书的情况）。
-
目标 URL 无效。
-
导航期间超过超时时间。
-
远程服务器无响应或不可达。
-
主资源加载失败。
-
URL 被黑名单/白名单规则阻止。
备注
导航到 about:blank，或使用不同 hash 导航到相同 URL，都会成功并返回 null。
警告
无头 shell 模式不支持导航到 PDF 文档。请参阅上游问题。
在无头 shell 中，当远程服务器返回任何有效的 HTTP 状态码（包括 404 "Not Found" 和 500 "Internal Server Error"）时，此方法不会抛出错误。此类响应的状态码可以通过调用 HTTPResponse.status() 获取。