Проверьте, появился ли идентификатор загрузки, и найдите её текущее состояние в браузере. Принятый запрос не означает готовый файл. Если старт не состоялся, исследуйте ошибку API и параметры; если запись есть, смотрите причину прерывания или ожидания. Начните с небольшого безопасного файла под контролем проекта, не с исполняемого пакета неизвестного происхождения.
Chrome downloads API различает in_progress, interrupted и complete, а метод начала загрузки возвращает ID при успешном старте. Документация проверена 23 октября 2026 года. Интерфейс расширения должен отражать эту разницу. Сообщение «скачано» сразу после получения ID скрывает сетевой отказ, отмену пользователя и последующие проверки браузера.
Определите границу отказа
| Состояние | Что проверить |
|---|---|
| Нет ID загрузки | Отказ старта, разрешение API и параметры |
| В процессе | Ожидание данных, выбор сохранения и прогресс |
| Прервана | Документированную причину и допустимость повтора |
| Завершена | Фактический результат в истории загрузок |
| Требуется решение пользователя | Показать штатный путь, не обходить защиту |
Отдельно сравните разрешение downloads в manifest и возможность получить сам ресурс. Успех API не даёт доступа к любому закрытому файлу сервера. Ссылка может истечь, привести на страницу входа или вернуть другой ответ. В диагностике сохраняйте безопасную причину и тип результата, не токены временных URL и не содержимое приватного документа.
Следите за конкретной загрузкой, а не за общим флагом
Условная модель:
запрос пользователя -> разрешённый источник
старт -> downloadId или обработанный отказ
изменения -> состояние именно этого downloadId
complete -> подтверждённый итог браузера
interrupted -> причина и следующее действие
повтор -> сверка существующей попытки до нового стартаЗакрытие popup не должно превращать загрузку в потерянную операцию. Состояние можно повторно получить при следующем открытии интерфейса. Если запрос уже создал загрузку, а UI потерял ответ, автоматический новый старт способен сделать вторую копию. Храните связь пользовательской операции с загрузкой и показывайте неопределённость до сверки.
Блокировка по безопасности не исправляется отключением защиты браузера или автоматическим принятием опасного файла. Проверьте доверенный источник, целостность и назначение содержимого, затем используйте штатный процесс решения пользователя. Корпоративная политика также не является ошибкой, которую расширение вправе тайно обойти. Причину объясняйте без совета ослабить защиту всего профиля.
Контрольный сценарий включает отмену
- Скачать безопасный искусственный файл до конечного состояния.
- Отменить сохранение и не увидеть ложного успеха.
- Прервать сеть в тесте и получить понятный статус.
- Закрыть и открыть popup без второго скачивания.
- Проверить недоступную ссылку без бесконечной очереди повторов.
Не разбирайте свободный текст ошибки старта как вечный машинный контракт: документация предупреждает, что строки могут меняться. Для решений используйте доступные структурированные состояния и собственные безопасные категории, сохраняя исходную причину в ограниченной диагностике. Название файла проверяется отдельно от завершения передачи.
Для разбора нужны версия браузера, минимальный manifest, ID тестовой загрузки и последовательность её состояний. Удаление записей истории и удаление файлов — разные операции и не нужны для первичной проверки. Исправление подтверждено, когда расширение честно показывает итог каждой попытки и не создаёт дубли при восстановлении интерфейса.