Download
Downloadオブジェクトは、ページによってPage.Downloadイベントを介してディスパッチされます。
ブラウザコンテキストに属するダウンロードされたファイルはすべて、ブラウザコンテキストが閉じられるときに削除されます。
ダウンロードイベントは、ダウンロードが開始されると発行されます。ダウンロードパスは、ダウンロードが完了すると利用可能になります。
// Start the task of waiting for the download before clicking
var waitForDownloadTask = page.WaitForDownloadAsync();
await page.GetByText("Download file").ClickAsync();
var download = await waitForDownloadTask;
// Wait for the download process to complete and save the downloaded file somewhere
await download.SaveAsAsync("/path/to/save/at/" + download.SuggestedFilename);
メソッド
CancelAsync
追加されたバージョン: v1.13ダウンロードをキャンセルします。ダウンロードが既に完了しているかキャンセルされている場合でも失敗しません。キャンセルが成功した場合、download.failure()は'canceled'に解決されます。
使用法
await Download.CancelAsync();
戻り値
CreateReadStreamAsync
v1.9より前に追加成功したダウンロードの読み取り可能なストリームを返します。失敗したダウンロードまたはキャンセルされたダウンロードの場合は例外をスローします。
使用法
await Download.CreateReadStreamAsync();
戻り値
- [Stream]#
DeleteAsync
v1.9より前に追加ダウンロードされたファイルを削除します。必要であればダウンロードが完了するまで待機します。
使用法
await Download.DeleteAsync();
戻り値
FailureAsync
v1.9より前に追加ダウンロードエラーがあれば返します。必要であればダウンロードが完了するまで待機します。
使用法
await Download.FailureAsync();
戻り値
Page
追加されたバージョン: v1.12ダウンロードが属するページを取得します。
使用法
Download.Page
戻り値
PathAsync
v1.9より前に追加成功したダウンロードの場合はダウンロードされたファイルへのパスを返します。失敗したダウンロードまたはキャンセルされたダウンロードの場合は例外をスローします。必要であれば、このメソッドはダウンロードが完了するまで待機します。リモート接続されている場合は、このメソッドは例外をスローします。
ダウンロードのファイル名はランダムなGUIDであることに注意してください。Download.SuggestedFilenameを使用して推奨ファイル名を取得してください。
使用法
await Download.PathAsync();
戻り値
SaveAsAsync
v1.9より前に追加ダウンロードをユーザー指定のパスにコピーします。ダウンロードが進行中でもこのメソッドを呼び出すのは安全です。必要であればダウンロードが完了するまで待機します。
使用法
await download.SaveAsAsync("/path/to/save/at/" + download.SuggestedFilename);
引数
戻り値
SuggestedFilename
v1.9より前に追加このダウンロードの推奨ファイル名を返します。これは通常、ブラウザがContent-Dispositionレスポンスヘッダーまたはdownload属性から計算します。whatwgの仕様を参照してください。異なるブラウザは、計算に異なるロジックを使用する場合があります。
使用法
Download.SuggestedFilename
戻り値
Url
v1.9より前に追加ダウンロードされたURLを返します。
使用法
Download.Url
戻り値