メインコンテンツにスキップ
バージョン: 22.5.0

Frame.goto() メソッド

フレームを指定された url にナビゲートします。

シグネチャ:​

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

パラメータ​

パラメータ型説明
urlstringフレームをナビゲートする先の URL。URLにはスキームを含める必要があります (例: https://)。
optionsGoToOptions(オプション) 待機動作を設定するオプション。

戻り値

Promise<HTTPResponse | null>

メインリソースのレスポンスに解決される Promise。複数リダイレクトの場合、ナビゲーションは最後のリダイレクトのレスポンスで解決されます。

例外​

次の場合は

  • SSLエラーが発生した場合（例：自己署名証明書の場合）。- 対象のURLが無効な場合。- ナビゲーション中にタイムアウトした場合。- リモートサーバーが応答しない場合、または到達不能な場合。- メインリソースの読み込みに失敗した場合。

このメソッドは、リモートサーバーから有効なHTTPステータスコードが返された場合（404 "Not Found" や 500 "Internal Server Error"を含む）でもエラーをスローしません。このようなレスポンスのステータスコードは、HTTPResponse.status()を呼び出すことで取得できます。

注釈​

about:blankへのナビゲーション、または異なるハッシュを持つ同じURLへのナビゲーションは成功し、nullを返します。

警告

ヘッドレスモードでは、PDFドキュメントへのナビゲーションはサポートされていません。 upstream issue を参照してください。