Download

Объекты Download создаются на странице через событие Page.Download.

Все загруженные файлы, принадлежащие контексту браузера, удаляются при закрытии контекста браузера.

Событие загрузки генерируется, как только начинается загрузка. Путь к загруженному файлу становится доступным после завершения загрузки.

// Начните задачу ожидания загрузки перед кликом
var waitForDownloadTask = page.WaitForDownloadAsync();
await page.GetByText("Download file").ClickAsync();
var download = await waitForDownloadTask;

// Дождитесь завершения процесса загрузки и сохраните загруженный файл в указанное место
await download.SaveAsAsync("/path/to/save/at/" + download.SuggestedFilename);

---

Методы

CancelAsync

Добавлено в: v1.13 download.CancelAsync

Отменяет загрузку. Не вызовет ошибку, если загрузка уже завершена или отменена. При успешной отмене download.failure() вернется значение 'canceled'.

Использование

await Download.CancelAsync();

Возвращает

• void#

---

CreateReadStreamAsync

Добавлено до v1.9 download.CreateReadStreamAsync

Возвращает поток для чтения для успешной загрузки или вызывает ошибку для неудачной/отмененной загрузки.

примечание

Если вам не нужен читаемый поток (readable stream), обычно проще прочитать файл с диска после завершения скачивания. См. Download.PathAsync().

Использование

await Download.CreateReadStreamAsync();

Возвращает

• [Stream]#

---

DeleteAsync

Добавлено до v1.9 download.DeleteAsync

Удаляет загруженный файл. При необходимости будет ожидать завершения загрузки.

Использование

await Download.DeleteAsync();

Возвращает

• void#

---

FailureAsync

Добавлено до v1.9 download.FailureAsync

Возвращает ошибку загрузки, если таковая имеется. При необходимости будет ожидать завершения загрузки.

Использование

await Download.FailureAsync();

Возвращает

• string?#

---

Page

Добавлено в: v1.12 download.Page

Получает страницу, к которой относится загрузка.

Использование

Download.Page

Возвращает

• Page#

---

PathAsync

Добавлено до v1.9 download.PathAsync

Возвращает путь к загруженному файлу для успешной загрузки или вызывает ошибку для неудачной/отмененной загрузки. Метод будет ожидать завершения загрузки, если это необходимо. Метод вызывает ошибку при подключении удаленно.

Обратите внимание, что имя файла загрузки является случайным GUID, используйте Download.SuggestedFilename для получения предложенного имени файла.

Использование

await Download.PathAsync();

Возвращает

• string#

---

SaveAsAsync

Добавлено до v1.9 download.SaveAsAsync

Копирует загрузку в указанный пользователем путь. Этот метод безопасно вызывать, пока загрузка еще продолжается. При необходимости будет ожидать завершения загрузки.

Использование

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

Аргументы

• path string#

  Путь, куда должна быть скопирована загрузка.

Возвращает

• void#

---

SuggestedFilename

Добавлено до v1.9 download.SuggestedFilename

Возвращает предложенное имя файла для этой загрузки. Обычно оно вычисляется браузером из заголовка ответа Content-Disposition или атрибута download. См. спецификацию на whatwg. Разные браузеры могут использовать разную логику для его вычисления.

Использование

Download.SuggestedFilename

Возвращает

• string#

---

Url

Добавлено до v1.9 download.Url

Возвращает URL загруженного файла.

Использование

Download.Url

Возвращает

• string#