跳至主要内容

下载

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​

Added in: v1.13 download.CancelAsync

取消下载。如果下载已完成或已取消，操作不会失败。成功取消后，download.failure()将解析为'canceled'。

用法

await Download.CancelAsync();

返回

CreateReadStreamAsync​

Added before v1.9 download.CreateReadStreamAsync

返回一个成功下载的可读流，或在下载失败/取消时抛出异常。

用法

await Download.CreateReadStreamAsync();

返回

  • [流]#

DeleteAsync​

Added before v1.9 download.DeleteAsync

删除已下载的文件。如有必要，将等待下载完成。

用法

await Download.DeleteAsync();

返回

FailureAsync​

Added before v1.9 download.FailureAsync

如果有下载错误则返回错误信息。必要时会等待下载完成。

用法

await Download.FailureAsync();

返回

页面​

Added in: v1.12 download.Page

获取下载所属的页面。

用法

Download.Page

返回

PathAsync​

Added before v1.9 download.PathAsync

对于成功的下载，返回下载文件的路径；对于失败/取消的下载则抛出异常。该方法会在必要时等待下载完成。当远程连接时会抛出异常。

请注意下载的文件名是一个随机GUID，使用Download.SuggestedFilename来获取建议的文件名。

用法

await Download.PathAsync();

返回

SaveAsAsync​

Added before v1.9 download.SaveAsAsync

将下载内容复制到用户指定的路径。在下载仍在进行时调用此方法是安全的。如有必要，将等待下载完成。

用法

await download.SaveAsAsync("/path/to/save/at/" + download.SuggestedFilename);

参数

  • path string#

    下载文件应复制到的路径。

返回

建议的文件名​

Added before v1.9 download.SuggestedFilename

返回此下载的建议文件名。通常由浏览器根据Content-Disposition响应头或download属性计算得出。详情请参阅whatwg规范。不同浏览器可能采用不同的计算逻辑。

用法

Download.SuggestedFilename

返回

网址​

Added before v1.9 download.Url

返回下载的URL。

用法

Download.Url

返回