Skip to main content

Download

Объекты Download отправляются страницей через событие page.on('download').

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

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

// Начинаем ожидать загрузку перед кликом. Обратите внимание, что нет await.
const downloadPromise = page.waitForEvent('download');
await page.getByText('Download file').click();
const download = await downloadPromise;

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

Методы​

cancel​

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

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

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

await download.cancel();

Возвращает

createReadStream​

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

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

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

await download.createReadStream();

Возвращает

delete​

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

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

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

await download.delete();

Возвращает

failure​

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

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

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

await download.failure();

Возвращает

page​

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

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

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

download.page();

Возвращает

path​

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

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

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

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

await download.path();

Возвращает

saveAs​

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

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

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

await download.saveAs('/path/to/save/at/' + download.suggestedFilename());

Аргументы

  • path string#

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

Возвращает

suggestedFilename​

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

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

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

download.suggestedFilename();

Возвращает

url​

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

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

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

download.url();

Возвращает