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

Download

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

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

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

# Начать ожидание загрузки
with page.expect_download() as download_info:
    # Выполнить действие, инициирующее загрузку
    page.get_by_text("Download file").click()
download = download_info.value

# Дождаться завершения процесса загрузки и сохранить загруженный файл куда-нибудь
download.save_as("/path/to/save/at/" + download.suggested_filename)

Методы​

cancel​

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

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

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

download.cancel()

Возвращает

delete​

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

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

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

download.delete()

Возвращает

failure​

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

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

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

download.failure()

Возвращает

path​

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

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

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

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

download.path()

Возвращает

save_as​

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

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

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

download.save_as("/path/to/save/at/" + download.suggested_filename)

Аргументы

  • path Union[str, pathlib.Path]#

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

Возвращает

Свойства​

page​

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

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

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

download.page

Возвращает

suggested_filename​

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

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

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

download.suggested_filename

Возвращает

url​

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

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

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

download.url

Возвращает