Chrome 156 разрешил повторять динамический импорт после сетевого сбоя: конец вечной блокировки модулейЗаметка · дайджест за 13 ноября
Концептуальная 3D-композиция механизма повторного динамического импорта модулей JavaScript в браузере Chrome.
Заметка3 раздела≈ 3 мин

Chrome 156 разрешил повторять динамический импорт после сетевого сбоя: конец вечной блокировки модулей

С обработкой сбоев динамического импорта import() в JavaScript легко запутаться даже опытному инженеру. Кажется очевидным: раз вызов возвращает обычный промис, то при обрыве связи его можно обернуть в try/catch, выждать паузу и вызвать снова — как обычный fetch(). Но стоило соединению моргнуть на долю секунды, как повторные попытки мгновенно падали с ошибкой Failed to fetch dynamically imported module, даже не выходя в сеть.

Я не раз видел, как разработчики грешили на баги сборщика или сервис-воркера, хотя причина крылась в стандарте браузерных ES-модулей. Как тогда подгружать тяжелые части веб-приложения на нестабильном мобильном интернете без перезагрузки всей вкладки? С выходом Chrome 156 это ограничение снято, и повторный вызов import() начал работать так, как от него интуитивно ждут.

Ловушка Module Map: почему один обрыв связи блокировал модуль до перезагрузки

Возьмём реальный сценарий из разбора канала «Библиотека фронтендера»: пользователь едет в метро и нажимает кнопку редактирования документа, а приложение лениво подгружает тяжелый скрипт ./editor.js. Если в этот миг поезд въезжает в тоннель и связь пропадает, запрос обрывается.

Почему после выезда на станцию повторный клик снова выдавал отказ без единого сетевого пакета? Виноват внутренний реестр страницы — карта модулей (Module Map). Она работает как журнал у строгого вахтёра на проходной: ключом служит полный URL скрипта, а напротив записывается итог первого обращения. Раньше спецификация требовала хранить любой результат вечно. Если курьер с файлом ./editor.js не доехал из-за обрыва сети или ответа 503 от шлюза, вахтёр ставил штамп «отказ» и больше не звонил в доставку, с порога возвращая сохранённый отклонённый промис до обновления вкладки. Обходить это приходилось костылями вроде import('./editor.js?t=' + Date.now()), плодя дубликаты в памяти.

Эфемерные сбои сети и постоянные ошибки кода в Chrome 156

Вслед за импортом текстовых модулей в Chrome 155 и новинками CSS в Chrome 156 стандарт WHATWG HTML (поправка #10327) разделил сбои загрузки на два чётких сценария:

  • Если сбой произошёл на этапе сетевого запроса (пропала связь или сервер вернул ошибку 404 или 500), то ошибка признаётся временной (эфемерной). Браузер очищает неудачную запись из Module Map, поэтому следующий вызов import("./editor.js") отправляет честный повторный HTTP-запрос по чистому URL.
  • Если же файл скачался, но упал при разборе или выполнении (ошибка SyntaxError или исключение внутри модуля), то отказ кешируется навсегда. Повторно качать с сервера заведомо сломанный код бессмысленно.

Безопасный повтор загрузки редактора и разумные границы ретраев

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

async function loadEditor() {
  try {
    return await import("./editor.js");
  } catch {
    await new Promise(resolve => setTimeout(resolve, 500));
    return import("./editor.js");
  }
}

В рантайме первый вызов await import("./editor.js") в блоке try запускает штатную загрузку скрипта. При потере сигнала в тоннеле промис отклоняется, но Chrome 156 сразу очищает запись ./editor.js в Module Map. В блоке catch таймер setTimeout выдерживает паузу в 500 мс, после чего return import("./editor.js") заново обращается к серверу и открывает редактор без перезагрузки вкладки.

Но здесь важно вовремя остановиться и не превращать ретраи в безостановочную осаду сервера. Заворачивать import() в бесконечный цикл while (true) нельзя: в глухом офлайне это быстро посадит батарею смартфона, а после свежего деплоя, когда старый файл чанка удалён с CDN и отдаёт 404, повторы всё равно не помогут. Ограничься одной-двумя попытками, а при повторной неудаче покажи пользователю спокойное сообщение с предложением обновить страницу.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2