メインコンテンツにスキップ

Download

ダウンロードオブジェクトは、page.on("download") イベントを介してページによってディスパッチされます。

ブラウザコンテキストに属するすべてのダウンロードされたファイルは、ブラウザコンテキストが閉じられると削除されます。

ダウンロードイベントは、ダウンロードが開始されると発行されます。ダウンロードパスは、ダウンロードが完了すると利用可能になります。

# Start waiting for the download
with page.expect_download() as download_info:
    # Perform the action that initiates download
    page.get_by_text("Download file").click()
download = download_info.value

# Wait for the download process to complete and save the downloaded file somewhere
download.save_as("/path/to/save/at/" + download.suggested_filename)

メソッド​

cancel​

追加バージョン: v1.13 download.cancel

ダウンロードをキャンセルします。ダウンロードが既に完了しているかキャンセルされている場合でも失敗しません。キャンセルが成功すると、download.failure() は 'canceled' に解決されます。

使用法

download.cancel()

戻り値

delete​

v1.9より前に追加 download.delete

ダウンロードされたファイルを削除します。必要であれば、ダウンロードが完了するまで待機します。

使用法

download.delete()

戻り値

failure​

v1.9より前に追加 download.failure

ダウンロードエラーがあれば返します。必要であれば、ダウンロードが完了するまで待機します。

使用法

download.failure()

戻り値

path​

v1.9より前に追加 download.path

ダウンロードが成功した場合はダウンロードされたファイルへのパスを返し、失敗/キャンセルされたダウンロードの場合はスローします。このメソッドは必要に応じてダウンロードが完了するまで待機します。リモート接続されている場合はこのメソッドはスローします。

ダウンロードのファイル名がランダムな GUID であることに注意してください。download.suggested_filename を使用して、提案されたファイル名を取得します。

使用法

download.path()

戻り値

save_as​

v1.9より前に追加 download.save_as

ダウンロードをユーザー指定のパスにコピーします。ダウンロードが進行中でもこのメソッドを呼び出すのは安全です。必要に応じてダウンロードが完了するまで待機します。

使用法

download.save_as("/path/to/save/at/" + download.suggested_filename)

引数

戻り値

プロパティ​

page​

追加日: v1.12 download.page

ダウンロードが属するページを取得します。

使用法

download.page

戻り値

suggested_filename​

v1.9より前に追加 download.suggested_filename

このダウンロードの提案されたファイル名を返します。これは通常、ブラウザがContent-Disposition応答ヘッダーまたはdownload属性から計算します。whatwgの仕様を参照してください。異なるブラウザは、計算に異なるロジックを使用する場合があります。

使用法

download.suggested_filename

戻り値

url​

v1.9より前に追加 download.url

ダウンロードされたURLを返します。

使用法

download.url

戻り値