Download
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)
# 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)
方法
取消
添加于:v1.13取消下载。如果下载已完成或已取消,则不会失败。成功取消后,download.failure()
将解析为 'canceled'
。
用法
download.cancel()
返回
删除
v1.9 之前添加删除下载的文件。如有必要,将等待下载完成。
用法
download.delete()
返回
失败
v1.9 之前添加返回下载错误(如果有)。如有必要,将等待下载完成。
用法
download.failure()
返回
路径
v1.9 之前添加返回成功下载的下载文件路径,如果下载失败/取消,则抛出错误。如有必要,该方法将等待下载完成。当远程连接时,该方法会抛出错误。
请注意,下载的文件名是一个随机的 GUID,请使用 download.suggested_filename 来获取建议的文件名。
用法
download.path()
返回
保存为
v1.9 之前添加将下载内容复制到用户指定的路径。在下载仍在进行时调用此方法是安全的。如有必要,将等待下载完成。
用法
- 同步
- 异步
download.save_as("/path/to/save/at/" + download.suggested_filename)
await download.save_as("/path/to/save/at/" + download.suggested_filename)
参数
-
path
Union[str, pathlib.Path]#下载内容应复制到的路径。
返回
属性
页面
添加于:v1.12获取下载所属的页面。
用法
download.page
返回
建议文件名
v1.9 之前添加返回此下载的建议文件名。它通常由浏览器根据 Content-Disposition
响应头或 download
属性计算得出。请参阅 whatwg 规范。不同的浏览器可能使用不同的逻辑来计算它。
用法
download.suggested_filename
返回
网址
v1.9 之前添加返回下载的网址。
用法
download.url
返回