Download
Download 对象通过页面事件 Page.onDownload(handler) 分发。
所有属于浏览器上下文的下载文件在浏览器上下文关闭时将被删除。
下载事件在下载开始时触发。下载路径在下载完成后可用。
// 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()));
方法
cancel
新增于: v1.13取消下载。如果下载已完成或已取消,则不会失败。成功取消后,download.failure()
将解析为 'canceled'
。
用法
Download.cancel();
返回值
createReadStream
新增早于 v1.9返回成功下载的可读流,或对失败/取消的下载抛出异常。
用法
Download.createReadStream();
返回值
delete
新增早于 v1.9删除下载文件。如有必要,将等待下载完成。
用法
Download.delete();
返回值
failure
新增早于 v1.9返回下载错误(如果有)。如有必要,将等待下载完成。
用法
Download.failure();
返回值
page
新增于: v1.12获取下载所属的页面。
用法
Download.page();
返回值
path
新增早于 v1.9返回成功下载的下载文件路径,或对失败/取消的下载抛出异常。如有必要,该方法将等待下载完成。远程连接时该方法会抛出异常。
注意,下载的文件名是一个随机 GUID,请使用 Download.suggestedFilename() 获取建议的文件名。
用法
Download.path();
返回值
saveAs
新增早于 v1.9将下载复制到用户指定的路径。在下载仍在进行时调用此方法是安全的。如有必要,将等待下载完成。
用法
download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));
参数
返回值
suggestedFilename
新增早于 v1.9返回此下载的建议文件名。它通常由浏览器根据 Content-Disposition
响应头或 download
属性计算得出。请参阅 whatwg 上的规范。不同的浏览器可以使用不同的逻辑来计算它。
用法
Download.suggestedFilename();
返回值
url
新增早于 v1.9返回下载的 url。
用法
Download.url();
返回值