Статьи Nazara
Как проверять результат загрузки файла в приложение
Как отличить передачу файла от обработки, проверить содержимое и повторное открытие, разобрать отказ и принять загрузку на безопасном образце.
Результат загрузки файла проверяют по тому, что с документом можно сделать после передачи: открыть нужную версию, увидеть ожидаемое содержимое и вернуться к ней позже. Полоса «100%» сама по себе этого не подтверждает. Ниже — порядок приёмки на безопасном учебном файле: Вы разделите передачу, обработку и готовность документа, а затем составите понятный список проверок для разработчика приложения.
Определите, какое действие означает готовность файла
Начните с рабочего сценария. Если сотрудник отправляет документ для просмотра, результатом будет доступный и читаемый документ. Если загружает таблицу для дальнейшей работы, нужно отдельно проверить, что приложение приняло нужные данные. У этих сценариев разные критерии; слово «загружено» не должно скрывать, какой именно этап завершён.
Запишите одну фразу приёмки: «После загрузки учебного PDF сотрудник открывает карточку документа, видит обе страницы в правильном порядке и находит файл после обновления страницы». Это пример задания, а не описание функции конкретного сервиса Nazara. Для другого приложения замените PDF и просмотр на фактически предусмотренное действие.
Уточните, где документ должен появиться: в личном списке, внутри проекта или в общей папке. Файл может существовать на сервере и при этом не быть связан с нужной карточкой. Поэтому проверять только наличие имени в уведомлении недостаточно. Завершение рабочего сценария требует правильного места и понятной связи с действием пользователя.
Заранее договоритесь о границе этой проверки. Приёмка загрузки подтверждает наблюдаемое поведение приложения на выбранных примерах. Она не заменяет аудит безопасности, резервного копирования или сроков хранения. Эти задачи проверяют отдельно; зелёная отметка возле файла не доказывает их выполнение.
Разделите передачу, обработку и готовность
У загрузки могут быть несколько самостоятельных состояний. Пользователь выбрал файл; браузер передаёт его; приложение приняло запрос; затем проверяет или преобразует документ. Только после необходимых действий становится доступен результат. Конкретная цепочка зависит от реализации, поэтому согласуйте названия состояний с разработчиком.
| Наблюдаемое состояние | Что уже известно | Что ещё проверить |
|---|---|---|
| Файл выбран | Браузер получил выбор пользователя | Началась ли передача |
| Передача завершена | Завершился соответствующий этап отправки | Какой ответ вернул сервис |
| Принят в обработку | Задача зарегистрирована | Закончилась ли проверка документа |
| Готов к использованию | Доступно согласованное рабочее действие | Верный ли файл и сохраняется ли результат |
Технические сигналы тоже требуют правильной трактовки. В документации XMLHttpRequest.upload события относятся к передаче данных. Они не являются самостоятельной проверкой содержимого документа. Для приёмки спросите, каким отдельным сигналом приложение подтверждает готовность результата.
Ответ HTTP 202 означает принятие запроса для обработки, которая ещё не завершена; её успех не гарантирован. Такое значение описано в справке MDN о 202 Accepted. В интерфейсе этому состоянию подходит сообщение об обработке, если дальнейшая работа действительно продолжается. Нельзя автоматически превращать его в обещание, что документ уже доступен.
Подготовьте образец, по которому видно ошибку
Создайте небольшой учебный документ без клиентских сведений. Для просмотра удобно взять две страницы с разными крупными геометрическими фигурами. На первой разместите круг и квадрат, на второй — треугольник. После загрузки будет проще заметить потерянную страницу, неверный порядок или подмену превью. Это контрольный образец, а не реальный клиентский файл.
Сохраните исходник отдельно от результата. Запишите имя, формат, размер, число страниц и отличительные признаки. Если проверяется новая версия, сделайте отличие заметным: измените одну фигуру или заголовок учебного документа. Два практически одинаковых файла с одинаковым именем плохо подходят для обнаружения подмены.
Не ограничивайте набор только удобным маленьким файлом. Возьмите ещё один допустимый пример ближе к согласованному ограничению размера, если такое ограничение установлено. Отдельно подготовьте неподдерживаемый формат для проверки отказа. Точные размеры и типы берите из требований приложения; универсального допустимого объёма здесь нет.
Для каждого образца укажите ожидаемое поведение. У корректного файла — доступный результат; у неподдерживаемого — понятное объяснение без ложного успеха. Не повреждайте рабочие документы ради проверки. Если нужен тест повреждённого файла, подготовьте отдельную безопасную копию и согласуйте такой сценарий с командой.

Пройдите обычную загрузку до рабочего результата
Откройте приложение в согласованной роли и выберите место назначения. Загрузите первый образец один раз. Наблюдайте, меняется ли состояние, можно ли понять текущий этап и остаётся ли сообщение об обработке доступным после завершения передачи. Запишите фактическую последовательность, а не только последний экран.
Когда приложение сообщает о готовности, выполните действие из критерия приёмки. Откройте документ, проверьте страницы и отличительные признаки, затем вернитесь в список. Если предусмотрено скачивание, сравните скачанный файл с исходным безопасным образцом. Наличие кнопки не подтверждает, что она отдаёт правильный документ.
После этого загрузите второй допустимый образец. Проверьте, что первый не исчез и карточки не перепутались. Затем повторите сценарий с новой версией того же учебного документа. Согласуйте заранее, создаётся ли отдельная запись или заменяется прежняя. Приёмка должна проверять выбранное правило, а не навязывать приложению неподтверждённый способ хранения версий.
Если приложение извлекает данные, разнесите две проверки: документ сохранён и данные обработаны правильно. Не переносите успех первого шага на второй. Для проверки состава и значений импортируемой таблицы используйте отдельную методику проверки импорта данных; эта статья отвечает за жизненный цикл загруженного файла.
Проверьте отказ и повтор без случайных дублей
Следующий проход посвящён неудачной попытке. На безопасном стенде или в согласованном тестовом режиме проверьте неподдерживаемый формат, прерывание передачи и ошибку последующей обработки. Не отключайте рабочие сервисы и не создавайте нагрузку на production ради статьи. Цель — наблюдать предусмотренные состояния на контролируемых примерах.
Сообщение об ошибке должно позволять выбрать следующий шаг. При передаче заново нужен повтор; при неверном формате — другой файл; при временной обработке — проверка текущего состояния. Универсальное «попробуйте снова» может создать лишнюю копию, если первая попытка фактически была принята, а ответ до браузера не дошёл.
Согласуйте правило повторной отправки с разработчиком. Сначала проверьте список и статус прежней попытки, затем выполните разрешённое действие. Если система различает попытки по идентификатору, зафиксируйте его в техническом протоколе без секретов. Не обещайте отсутствие дублей только потому, что кнопка временно заблокирована: повтор возможен и после обновления страницы.
Для технической проверки полезно знать, что Fetch API требует отдельно проверять статус HTTP-ответа: ответ с ошибочным статусом сам по себе не обязательно отклоняет promise. Это задача реализации; владельцу приложения достаточно потребовать, чтобы ошибка сервиса не отображалась как успешная готовность файла.
Вернитесь к документу после обновления страницы
Обновите страницу после успешного завершения, откройте список заново и найдите учебный документ обычным маршрутом. Проверьте содержимое повторно. Превью, оставшееся в памяти открытой вкладки, ещё не доказывает, что результат можно получить при следующем обращении.
Если предусмотрен личный кабинет, повторите вход в той же согласованной роли. Для общих проектов проверьте доступ второго тестового участника только в пределах уже разрешённых прав. Не открывайте реальные чужие документы. Здесь требуется подтвердить доступность именно учебного объекта в назначенном месте, а не расширять права ради успешного теста.
Проверьте длинную обработку: пользователь ушёл со страницы, затем вернулся. Состояние должно отражать фактическую задачу, если приложение предусматривает её продолжение. Команда должна отдельно определить, что происходит при закрытии вкладки. Нельзя считать фоновую обработку существующей возможностью по одному анимированному индикатору.
Когда результат доступен лишь ограниченное время, зафиксируйте это условие в критерии. Для постоянного хранения нужен другой сценарий проверки. Публичный текст и сообщение интерфейса должны совпадать с подтверждённым поведением: слово «сохранено» создаёт ожидание последующего доступа, которое нужно проверить.

Передайте разработчику воспроизводимый протокол
Для каждого прохода сохраните роль, безопасный образец, шаги, ожидаемое и фактическое состояние. Укажите, где прекратился рабочий сценарий: передача, получение ответа, обработка, открытие или возвращение к файлу. Формулировка «загрузка сломалась» слишком широка для проверки исправления.
Вместо клиентского документа передайте учебный файл, на котором ошибка повторяется. Снимок экрана должен показывать нужное состояние без контактов, токенов и соседних документов. Если нужны внутренние технические сведения, передавайте их по согласованному рабочему каналу, не помещая в публичное описание проблемы.
Проверка готовности загрузки
Этот список помогает организовать ручную приёмку и не проверяет приложение автоматически. Перед передачей сотрудникам включите подтверждённый порядок загрузки в инструкцию. В разделе приложений Nazara можно посмотреть направления работы; для обсуждения конкретной загрузки опишите сценарий через Умную форму, не прикладывая конфиденциальные файлы.
Частые вопросы
Подтверждает ли 100% успешную загрузку
Это зависит от значения индикатора. Если он показывает передачу, отдельно нужны ответ сервиса, завершение обработки и доступное рабочее действие с правильным файлом.
Почему файл принят, но пока не открывается
Возможна отдельная обработка, но причину устанавливают по фактическому состоянию приложения. Не следует автоматически объявлять ожидание нормальным или повторять отправку без проверки прежней попытки.
Нужно ли проверять каждый формат
Набор определяют требования приложения. Минимум должен покрывать заявленные типы и согласованные ограничения; успешный PDF не подтверждает работу с таблицами или изображениями.
Как проверить загрузку без данных клиента
Подготовьте учебный документ с заметными различиями страниц или версий. Он должен позволять увидеть ту же проблему без персональных и коммерческих сведений.
Означает ли превью, что исходник сохранён
Нет, это отдельное утверждение. Если хранение исходника предусмотрено, проверьте его получение после возвращения в приложение и сравните с безопасным образцом.
Можно ли принять загрузку, если известна ошибка повторной отправки
Сначала определите её влияние и согласуйте решение с ответственным. Нельзя отметить проверку дублей как пройденную, если повтор создаёт неверный результат в предусмотренном рабочем сценарии.