Download

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();

傳回

• void#

---

CreateReadStreamAsync

Added before v1.9 download.CreateReadStreamAsync

傳回成功下載的可讀取串流，或針對失敗/取消的下載擲回例外。

用法

await Download.CreateReadStreamAsync();

傳回

• [Stream]#

---

DeleteAsync

Added before v1.9 download.DeleteAsync

刪除已下載的檔案。如有必要，將等待下載完成。

用法

await Download.DeleteAsync();

傳回

• void#

---

FailureAsync

Added before v1.9 download.FailureAsync

傳回下載錯誤（如果有的話）。如有必要，將等待下載完成。

用法

await Download.FailureAsync();

傳回

• string?#

---

Page

Added in: v1.12 download.Page

取得下載所屬的頁面。

用法

Download.Page

傳回

• Page#

---

PathAsync

Added before v1.9 download.PathAsync

傳回成功下載的已下載檔案路徑，或針對失敗/取消的下載擲回例外。如有必要，此方法將等待下載完成。遠端連線時，此方法會擲回例外。

請注意，下載的檔案名稱是隨機 GUID，請使用 Download.SuggestedFilename 取得建議的檔案名稱。

用法

await Download.PathAsync();

傳回

• string#

---

SaveAsAsync

Added before v1.9 download.SaveAsAsync

將下載複製到使用者指定的路徑。在下載仍在進行中時呼叫此方法是安全的。如有必要，將等待下載完成。

用法

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

引數

• path string#

  應複製下載的路徑。

傳回

• void#

---

SuggestedFilename

Added before v1.9 download.SuggestedFilename

傳回此下載的建議檔案名稱。它通常由瀏覽器從 Content-Disposition 回應標頭或 download 屬性計算而得。請參閱 whatwg 上的規格。不同的瀏覽器可以使用不同的邏輯來計算它。

用法

Download.SuggestedFilename

傳回

• string#

---

Url

Added before v1.9 download.Url

傳回已下載的 URL。

用法

Download.Url

傳回

• string#