Frame.goto() 方法

將 frame 或 page 導航至指定的 url。

簽名

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

參數

參數	類型	描述
url	字串	要導航 frame 至的 URL。URL 應包含 scheme，例如 https://
options	GoToOptions	（可選） 設定等待行為的選項。

返回

Promise<HTTPResponse | null>

一個 Promise，解析為主資源回應。在多次重新導向的情況下，導航將使用最後一次重新導向的回應解析。

例外

如果

• 發生 SSL 錯誤（例如，在使用自簽憑證時）。

• 目標 URL 無效。

• 在導航期間超過逾時時間。

• 遠端伺服器沒有回應或無法連線。

• 主要資源無法載入。

備註

導航至 about:blank 或導航至具有不同 hash 的相同 URL 將會成功並返回 null。

警告

無頭 shell 模式不支援導航至 PDF 文件。請參閱 上游問題。

在無頭 shell 中，當遠端伺服器傳回任何有效的 HTTP 狀態碼時，此方法不會拋出錯誤，包括 404 "找不到" 和 500 "內部伺服器錯誤"。此類回應的狀態碼可透過呼叫 HTTPResponse.status() 取得。