ダウンロード

はじめに

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

ダウンロードされたファイルをどこに保存するかは、downloads_pathオプションをbrowser_type.launch()で指定できます。

注

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

ファイルダウンロードを処理する最も簡単な方法を以下に示します

同期

# 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)

非同期

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

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

バリエーション

ダウンロードが何によって開始されたか不明な場合でも、イベントを処理できます

同期

page.on("download", lambda download: print(download.path()))

非同期

async def handle_download(download):
    print(await download.path())
page.on("download", handle_download)

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

注

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