История страницы
Ждать окончания загрузки файла
...
Версия 1 (Java)
Группа действий: Браузеры
...
Описание
Действие скачивает файл со страницы браузера и ожидает окончания его полной загрузки.Настройки
Иконка действия
Параметры и их настройки
Свойство |
---|
Описание | Тип | Пример заполнения | Обязательность заполнения поля | |
---|---|---|---|---|
Параметры | ||||
Контекст |
Контекст действия для работы с браузером | Идентификатор сеанса браузера | ACTION_CONTEXT | Да |
Элемент |
Элемент, с которым работает действие. На странице в браузере этот элемент должен содержать URL, по которому можно скачать файл | Web-элемент | Да | ||
Имя файла |
Наименование, которое будет иметь скачанный файл. Указанное наименование может не совпадать с исходным наименованием файла на сайте |
Строка | Да | ||
Формат |
Формат, с которым будет скачан файл. Если указанное значение не совпадает с исходным форматом файла на сайте, открытие файла может сопровождаться ошибкой | Строка | Да | |
Путь к папке |
Folder path
Путь к папке, в которой будет сохранен файл |
Путь к папке | Да | ||
Тайм-аут |
Время ожидания ответа от ресурса, с которого будет скачан файл. Если время ожидания ответа превысит указанное значение, действие вернет ошибку. Задается в миллисекундах. Значение по умолчанию: 10000 мс | Число | 10 | Нет | |
Результаты | ||||
Результат |
Путь к скачанному файлу | Путь к файлу |
Особые условия использования
- Основной принцип работы действия: с помощью селениума действие будет находить указанный веб-элемент на странице и извлекать из него URL файла. Скачивать файл действие будет по URL уже через джаву, а не браузер. Пока файл не скачается, действие не закончит свою работу, т.е. робот будет ждать завершения сохранения файла.
- Если действие не нашло указанный элемент, действие возвращает ошибку.
- Если указанный элемент найден, но не содержит URL для скачивания файла, действие возвращает ошибку.
- Можно указывать любое имя для скачиваемого файла, даже если оно не совпадает с тем, которое изначально имеет файл - с таким наименованием файл и будет сохранен.
- Расширение файла указывается отдельно. Пример заполнения: .png, .xlsx и т.п. Действие не проверяет исходный формат файла, просто сохраняет файл в том формате, который указал пользователь в параметрах.
- Файл должен скачиваться в ту папку, которая указана в параметрах. Результат действия - полный путь к скачанному файлу.
- Если полный путь к файлу превышает допустимый в лимит системы на кол-во знаков в пути, действие сразу возвращает ошибку, не начиная скачивать файл.
- Если URL, указанный в веб-элементе, неверный, ведет на какую-то другую страницу, нет ответа от сервера, т.е. скачивание файл не начинается, действие возвращает ошибку.
- Если время ожидания ответа от ресурса превысит значение, указанное в поле тайм-аута, действие возвращает ошибку. Для пользователя в параметрах это одно поле тайм-аута, но в действии должна быть 2 ожидания: одно используется при установлении соединения по URL - ошибка будет, если не было установлено соединение в течение указанного времени; другое используется, когда уже началось скачивание, но данные перестали поступать - в этот момент начинается отсчет времени ожидания; ошибка будет, если данные не продолжат поступать в течение указанного времени.
Пример использования
Задача:
Решение:
Реализация:
Отсутствуют.
Пример использования
Задача
Открыть страницу в браузере https://fastest.fish/test-files и дождаться скачивания файла на рабочий стол, далее закрыть страницу браузера.
Решение
Воспользоваться действиями "Открыть браузер", "Ждать окончания загрузки файла", "Закрыть браузер".
Реализация
- Собрать схему робота, состоящую из действий.
- Настроить параметры для действия "Открыть браузер".
- Настроить параметры для действия "Ждать окончания загрузки файла".
- Настроить параметры для действия "Закрыть браузер".
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Требуемый файл скачан на рабочий стол.
Результат:
Обзор
Инструменты контента