ダウンロード

はじめに

ページによってダウンロードされる添付ファイルごとに、Page.onDownload(handler) イベントが発行されます。これらの添付ファイルはすべて一時フォルダーにダウンロードされます。イベントから取得したDownload オブジェクトを使用して、ダウンロード URL、ファイル名、およびペイロード ストリームを取得できます。

BrowserType.launch() の setDownloadsPath オプションを使用して、ダウンロードしたファイルを保存する場所を指定できます。

注

ダウンロードされたファイルは、それらを生成したブラウザコンテキストが閉じられると削除されます。

ファイルダウンロードを処理する最も簡単な方法は次のとおりです。

// Wait for the download to start
Download download = page.waitForDownload(() -> {
    // Perform the action that initiates download
    page.getByText("Download file").click();
});

// Wait for the download process to complete and save the downloaded file somewhere
download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));

バリエーション

何がダウンロードを開始したのかわからない場合でも、イベントを処理できます。

page.onDownload(download -> System.out.println(download.path()));

イベントを処理すると制御フローが分岐し、スクリプトが追跡しにくくなることに注意してください。メインの制御フローがこの操作の解決を待っていないため、ファイルをダウンロードしている間にシナリオが終了する可能性があります。

注

ファイルをアップロードする方法については、「ファイルのアップロード」セクションを参照してください。