Перейти к основному содержимому

Download

Объекты Download отправляются страницей через событие Page.onDownload(handler).

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

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

// Ожидание начала загрузки
Download download = page.waitForDownload(() -> {
    // Выполните действие, которое инициирует загрузку
    page.getByText("Download file").click();
});

// Ожидание завершения процесса загрузки и сохранение загруженного файла в указанное место
download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));

Методы​

cancel​

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

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

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

Download.cancel();

Возвращает

createReadStream​

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

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

примечание

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

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

Download.createReadStream();

Возвращает

delete​

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

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

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

Download.delete();

Возвращает

failure​

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

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

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

Download.failure();

Возвращает

page​

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

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

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

Download.page();

Возвращает

path​

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

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

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

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

Download.path();

Возвращает

saveAs​

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

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

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

download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));

Аргументы

  • path Path#

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

Возвращает

suggestedFilename​

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

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

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

Download.suggestedFilename();

Возвращает

url​

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

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

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

Download.url();

Возвращает