Сравните один тестовый файл с обычным перехватом и с временным обходом worker в инструментах разработчика. Если напрямую файл проходит, найдите обработчик fetch, который возвращает ответ для этого URL. Причиной может быть чтение всего тела, неверная работа с диапазонами или попадание файла в общий offline fallback.
Сначала выясните, что именно получает клиент
| Проверка | Что сравнить |
|---|---|
| Обычное скачивание | Статус, тип содержимого и размер |
| Медиаплеер | Range и Content-Range |
| Offline fallback | Не вернулся ли HTML вместо файла |
| Обработка тела | Не собирается ли ответ целиком в памяти |
| Кэширование | Полный объект или частичный ответ |
Возьмите синтетический файл известного размера и проверяйте содержимое, а не только появление имени в загрузках. Ответ 200 с HTML-заглушкой тоже может сохраниться под ожидаемым именем. Сопоставьте реальный Content-Type и полученные байты до правки заголовка Content-Disposition.
Условная карта маршрутизации:
request -> точный URL и назначение
large download -> предусмотренный сетевой путь
cached media -> обработка диапазонов
app navigation -> допустимая offline-страница
other -> штатное поведение
Не отправлять все неизвестные запросы в HTML fallback.Скачивание и воспроизведение имеют разные требования
Документация Workbox для кэшированных аудио и видео указывает на необходимость учитывать Range и использовать соответствующий модуль. Источник проверен 27 октября 2026 года. Готовый полный объект в кэше и частичный ответ сети — разные сущности; нельзя без проверки использовать один вместо другого.
Для обычного скачивания часто достаточно не перехватывать этот маршрут, если продукт не требует offline-доступа к файлу. Такое исключение должно быть точным по назначению и URL. Исключение всех запросов origin ради одного файла может незаметно отключить нужную offline-функцию приложения.
Проверьте вызовы blob, arrayBuffer и другие операции, которые материализуют тело целиком. На маленьком файле они незаметны, а на большом добавляют ожидание и расход памяти. Сохраняйте потоковую передачу там, где она предусмотрена, и не декодируйте бинарный ответ как текст.
Если файл должен храниться offline, заранее задайте предел размера и поведение при нехватке места. Нельзя сообщать «доступно без сети» после неудачной записи в Cache Storage. Учитывайте также смену версии файла: части разных редакций не должны смешиваться под одним ожидаемым объектом.
Один тест проходит через оба пути
- Выбрать разрешённый файл с известным содержимым.
- Снять ответ без перехвата и через worker.
- Проверить выбранный маршрут и операции над телом.
- Для медиа испытать переход в ещё не загруженную часть.
- Повторить с ошибкой сети и отсутствующим объектом в кэше.
Обход worker — диагностический шаг, а не окончательное исправление. После правки проверьте обычный пользовательский режим с активной регистрацией. Старый worker может продолжать обслуживать уже открытую вкладку, поэтому фиксируйте версию контроллера при каждом сравнении.
Не выключайте проверку доступа к файлу ради прямой загрузки. Сетевой маршрут должен сохранять авторизацию, а кэш — соответствовать политике данных. Подписанные URL и персональные ответы нельзя автоматически переносить в общий публичный кэш.
Для разбора подготовьте размер, тип запроса, версию worker и обезличенные заголовки двух ответов. Приёмка подтверждает совпадение содержимого, ограниченный расход ресурсов и правильную ошибку вместо подменённой HTML-страницы. У медиа отдельно проверяется произвольное чтение диапазона.