Надёжные тесты загрузки и скачивания файлов в браузерной автоматизации

Тесты файлов в браузерной автоматизации надёжны, когда тест владеет всеми входами и выходами, ждёт правильный признак завершения и отдельно проверяет приложение и сохранённые байты. Для загрузки используйте синтетический файл и известный элемент, подтвердите выбранное имя и состояние проверки, затем проверьте видимый результат приложения. Для скачивания выполните документированное действие, дождитесь события браузера, сохраните артефакт в уникальный путь этой попытки и проверяйте только нужные свойства. Удаляйте собственные временные файлы: локальное событие не доказывает удалённое удаление или окончание бизнес-операции.

У передачи несколько владельцев. Исполнитель теста владеет фикстурой и локальным путём; браузер показывает выбор и скачивание; приложение решает, принять ли файл; сервис может проверить, обработать, сохранить, отклонить или оставить его после завершения наблюдения браузера. Разделяйте эти результаты, чтобы диагностировать ошибку без чтения чужих файлов и без вывода их содержимого в журналы. Руководства Playwright по скачиваниям, загрузке файлов и загрузке Selenium описывают механизм, а не гарантию приложения.

Опишите контракт передачи

Начните с вопроса пользователя: появился ли ожидаемый документ, или приложение приняло выбранный файл и завершило действие? Разбейте ответ на наблюдаемые этапы. Загрузка может включать выбор, проверку в клиенте, отправку и подтверждение приложения. Скачивание может включать действие, событие передачи, локальный артефакт и изменение состояния приложения. Не объединяйте всё в расплывчатую проверку «файл работает».

До вызовов фреймворка опишите контракт фикстуры: синтетический ввод, формат и класс размера, страницу или элемент, ожидаемый результат, владельца рабочего процесса, путь вывода и очистку при успехе и ошибке. Запишите также, чего тест не доказывает. Сохранённый отчёт не доказывает фиксацию транзакции базы данных, а показанное имя не доказывает завершение удалённой обработки. В руководстве о фикстурах и изоляции подробнее описана ответственность за ресурсы.

Держите публичную границу сценария узкой. Используйте разрешённый тестовый маршрут и одобренную синтетическую учётную запись. Не открывайте выбор файлов реального пользователя, не отправляйте документы с машины, не перечисляйте серверные файлы и не считайте имя разрешением читать содержимое. Если нужен файл приложения, создайте его через документированный тестовый интерфейс и назначьте ответственного за удаление. Данные должны быть явно синтетическими, нечувствительными и пригодными для короткого хранения в закрытом окружении CI.

Определяйте успех на уровне продукта, а не только браузера. Форма может показать имя до отправки; браузер может выдать событие скачивания для отчёта с текстом ошибки. Выберите одну-две осмысленные проверки: видимое состояние, ожидаемый тип содержимого, стабильный заголовок, известный синтетический идентификатор или хеш для детерминированной фикстуры. Не сравнивайте все байты, если даты, идентификаторы или переводы строк должны различаться.

Выберите API и сохраните фикстуру отказа

Используйте эту краткую матрицу, чтобы выбрать самый узкий API браузера и понять, что он доказывает вместе с сохранённым локальным артефактом. Проверка приложения остаётся отдельной от события фреймворка.

Задача	Playwright	Selenium/WebDriver	Граница свидетельства
Назначить загрузку	locator.setInputFiles() или выбор файла	sendKeys() для <input type="file">	Выбор и клиентская проверка
Наблюдать скачивание	page.waitForEvent('download') до действия	Обработка драйвером и собственный путь	Передача и ограниченная проверка
Проверить отказ	Синтетическая фикстура с одним изменённым свойством	Та же фикстура через элемент файла	Ошибка поля и пригодность элемента
Очистить	finally удаляет каталог попытки	finally удаляет каталог попытки	Только локальное владение

Храните рядом с тестом копируемую фикстуру отказа. Она воспроизводит тайм-аут или отказ без сбора реального документа:

const attemptDir = await fs.mkdtemp(path.join(os.tmpdir(), 'file-transfer-'));
try {
  await page.locator('input[type=file]').setInputFiles('fixtures/rejected-type.txt');
  await expect(page.getByRole('alert')).toContainText('file type');
} finally {
  await fs.rm(attemptDir, { recursive: true, force: true });
}

Ожидаемый результат фикстуры: отказ, связанный с полем, после которого элемент остаётся пригодным. Тайм-аут скачивания использует тот же каталог попытки, но сохраняет первый тайм-аут как основную ошибку. Эта проверка относится к наблюдаемости передачи; общие правила владения фикстурами и сценарии доступности требуют собственных тестов.

Сделайте загрузку детерминированной

Предпочитайте поддержанную API файла фреймворка автоматизации оконному диалогу операционной системы. WebDriver задаёт локальный путь элементу <input type="file">, а Playwright устанавливает файлы или обрабатывает выбор файла. Такой подход не зависит от фокуса окна, темы рабочего стола, языка диалога и задержек нативного интерфейса. Нужны разрешённая страница и путь к собственной фикстуре. API фреймворка не заменяет проверки приложения и правил доступа; скрытый элемент допустим только как настоящий элемент документированного сценария.

Готовьте неизменяемые фикстуры. Для каждой задайте имя сценария, контролируемое расширение, известный тип, ограниченный размер и содержимое для конкретного случая. Валидное изображение должно быть маленьким известным изображением, а не случайным файлом машины с новым расширением. Для отказа меняйте одно свойство, например расширение или размер, чтобы связать ответ с причиной. Небольшой набор синтетических фикстур безопаснее коллекции реальных документов.

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

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

Метаданные файла нельзя считать достоверными. Расширение и MIME-тип от браузера могут отсутствовать, быть неточными или намеренно расходиться. Приложение должно само выполнять авторизацию, ограничение размера, разбор формата и проверку содержимого на сервере. Браузерный тест подтверждает публичный ответ на синтетический случай, но не работу сканера, права хранения или конвейер обработки. Для них нужны тесты приложения и свидетельства сервиса.

Сделайте скачивание наблюдаемым

Начинайте ожидание скачивания до действия, которое его вызывает. Быстрое событие не произойдёт до подписки теста. Событие браузера задаёт полезную границу передачи; затем артефакт можно сохранить в путь этой попытки и проверить минимальное свойство. Общая папка или имя создают зависимость от машины и столкновения при параллельном запуске. Используйте новый каталог для рабочего процесса и попытки под одобренным временным корнем.

Отделяйте завершённую передачу от правильного документа. Проверяйте предложенное имя только когда оно видно пользователю. Проверяйте MIME, сигнатуру, заголовок или структурное поле только при необходимости. Для детерминированного синтетического отчёта хеш даёт точное сравнение; для динамического отчёта проверяйте стабильные поля. Не выводите полные данные или base64 в журналы CI. Большой анализ выполняйте библиотекой формата и сохраняйте короткий результат.

Событие скачивания не доказывает правильность записи или право получить каждое поле. Проверяйте авторизацию и выбор содержимого на границе приложения. Для отчёта проверяйте синтетическую область и несколько нечувствительных полей. Для архива проверяйте ожидаемый элемент, а не извлекайте произвольные пути. Обход путей, пределы распаковки и опасные архивы требуют отдельных тестов приложения.

Не связывайте успех с настройкой папки скачивания, графической оболочкой или реальной папкой пользователя. Фреймворк может хранить файл во временном хранилище браузера до явного сохранения; детали зависят от версии. Используйте публичную API и её документированный срок хранения. Копируйте только в каталог, которым владеет тест, закрывайте страницу или контекст штатно и удаляйте копию в finally.

Изолируйте артефакты и параллельные процессы

Каждому рабочему процессу нужен личный простор артефактов. Включайте устойчивую метку сценария, процесса и попытки, но не используйте имя учётной записи, адрес почты или другой личный идентификатор. Структура может быть предсказуемой для CI, однако два процесса не должны писать один файл. Уникальный путь предотвращает перезапись, но не задаёт права чтения. Настройте доступ и срок хранения CI отдельно.

Считайте фикстуры входами только для чтения. Копируйте их в каталог теста, если сценарий должен изменить или переименовать файл. Один процесс не должен перезаписывать общую фикстуру во время чтения другим. Для созданных скачиваний используйте атомарное имя или новый каталог попытки и явно завершайте тест при отсутствии ожидаемого файла. Не принимайте старый файл только из-за совпадения имени.

Параллельные контексты разделяют cookies и хранилище браузера, но не изолируют файловую систему машины или записи сервера. Новый контекст не предотвращает общий экспорт, общий объект загрузки или гонку удаления удалённой фикстуры. Дайте каждому процессу отдельные синтетические данные либо документированную операцию сброса с владельцем. Сериализуйте только действительно общую мутацию: дополнительная задержка не является блокировкой.

Ограничивайте артефакты по чувствительности. Загруженный счёт, пакет диагностики или пользовательское изображение могут содержать личные данные даже в тесте. Предпочитайте синтетические файлы, ограничивайте доступ к исходным артефактам, задавайте короткий срок и оставляйте в обычном журнале метку сценария, категорию, размер, результат и состояние очистки. Снимок экрана делайте только на одобренной синтетической странице, когда он нужен для диагностики.

Очищайте и повторяйте безопасно

Очистка следует владению. Создавший временный каталог тест удаляет; владелец контекста закрывает его; приложение или сервис удаляет удалённый объект своей поддержанной операцией. Закрытие контекста не удаляет скопированное скачивание, не отменяет работу сервера и не удаляет загруженную запись. Помещайте локальную очистку в finally, чтобы отказ и тайм-аут использовали тот же путь. Ошибку очистки сообщайте рядом с первой ошибкой.

Делайте очистку идемпотентной. Тайм-аут может произойти после записи файла, но до регистрации успеха, а защитный обработчик может закрыть уже закрытый контекст. Проверяйте собственный путь и состояние ресурса, очищайте только созданное этой попыткой и отмечайте неполную очистку, если её нельзя подтвердить. Не сканируйте большой каталог машины и не удаляйте файлы только по имени или расширению.

Повтор означает новую попытку с отдельным каталогом. До повторной загрузки или экспорта определите, является ли действие чтением, идемпотентным или безопасно проверяемым по идентификатору сценария. Первый запрос мог дойти до сервиса, даже если браузер завершился по тайм-ауту. Проверьте состояние приложения, если оно документировано; иначе укажите неопределённость и не создавайте автоматический дубль.

Сохраняйте первую ошибку главной. Если скачивание истекло, а очистка тоже не удалась, квитанция должна показать обе причины. Укажите версии браузера и фреймворка, сценарий, ожидаемый сигнал, наличие артефакта и очистку. Не включайте cookies, заголовки авторизации, полный текст страниц, байты файла и личные имена. Этого достаточно для маршрутизации проблемы.

Проверьте границу приложения

Успех загрузки может означать выбор файла, принятие запроса, завершение асинхронной обработки или доступность объекта. Выберите смысл, который нужен пользователю, и проверяйте его на правильной границе. Сообщение «в очереди» доказывает постановку в очередь, но не окончание антивирусной проверки. Зелёное уведомление доказывает показ ответа, но не будущую доступность скачивания. Для постоянного хранения используйте документированный последующий экран или API для тестов.

У скачивания также несколько слоёв. Ссылка может вести не в ту область; браузер может получить страницу отказа; файл может сохраниться при ошибке сервера. Соедините видимое действие с ограниченной проверкой артефакта и, при необходимости, отдельной разрешённой проверкой приложения. Не собирайте посторонние запросы и не извлекайте скрытые данные аккаунта сетевой инспекцией. Инструментируйте только нужный запрос или результат.

Держите сквозные проверки соразмерными. Проверки имени, MIME, размера и серверной валидации обычно точнее и быстрее на уровне компонента или API. Браузерный тест оставляйте для пользовательского опыта: выбрать файл, увидеть доступную ошибку, начать скачивание и получить понятный результат. Небольшой набор проще диагностировать и он реже удерживает чувствительные артефакты. Руководство по трассировке Playwright описывает ограниченную диагностику.

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

Возможность и ограничение BotBrowser

BotBrowser предоставляет изолированные BrowserContexts с отдельным состоянием сессии браузера для повторяемых разрешённых проверок синтетических сценариев загрузки и скачивания. Команда запускает известный сценарий без cookies и хранилища другого контекста, затем сравнивает видимые выбор, проверку и завершение. Это полезно для авторизованного потока, где нужно контролировать начальное состояние. BotBrowser не контролирует каталог загрузки операционной системы, не проверяет обработку файла на сервере, не заменяет обработку событий фреймворком и безопасное управление временными файлами и не гарантирует удалённое удаление. См. изоляцию нескольких аккаунтов BotBrowser и жизненный цикл скачивания Playwright.

Изоляция BrowserContext не владеет каталогом операционной системы и не определяет, принял ли сервер файл, проверил, сохранил или удалил его. Исполнитель использует одобренные синтетические файлы, частные временные пути, проверки приложения, ограниченное хранение и поддержанную очистку сервиса. Чистый контекст свидетельствует только о состоянии браузера.

В рабочей квитанции фиксируйте версии браузера и фреймворка, сценарий, категорию синтетического входа, владельца пути, ожидаемый сигнал, наблюдаемый результат и состояние очистки. Не кладите сырые файлы в обычные журналы; храните их только для разрешённой диагностики. Указывайте, что наблюдалось: выбор, передача, принятие приложения или последующая доступность. Для серверного результата используйте документированный сигнал приложения, а не событие браузера.

Источники

• Playwright: скачивания
• Playwright: загрузка файлов
• Selenium: загрузка файлов
• MDN: File API
• BotBrowser: изоляция аккаунтов