Добавьте в тестовую сборку простую статическую метку popup и откройте инспектор именно этого окна. Если метки нет, исследуйте путь HTML и состав пакета. Если метка есть, но интерфейс не появился, смотрите загрузку JavaScript и ошибку инициализации. Так можно отделить пустую страницу от бесконечного ожидания ответа service worker.

Chrome регистрирует popup через action.default_popup; окно автоматически закрывается, когда пользователь переводит фокус наружу. Документация проверена 23 октября 2026 года. Не проектируйте его как постоянно живущую страницу приложения. При каждом новом открытии интерфейс должен заново получить актуальное состояние, не надеясь на переменные прошлого окна.

Статическая метка делит диагностику пополам

НаблюдениеСледующая проверка
Нет даже HTML-меткиПуть default_popup и файлы пакета
HTML есть, JS не стартовалРесурс скрипта, ошибка и политика выполнения
JS стартовал, данные не пришлиMessaging и доступность источника
Данные есть, экран пустУсловие рендера и обработка ошибки
После повторного открытия всё пропалоСостояние хранилось только в popup

Покажите три состояния вместо белого окна

Условная инициализация:
HTML загружен -> видимая основа
запуск UI -> состояние loading
данные получены -> проверка формата -> ready
отказ или таймаут -> error + безопасный повтор
закрытие popup -> не отменяет факт выполненной операции
новое окно -> запрос актуального состояния

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

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

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

Проверяйте короткую жизнь окна намеренно

  1. Открыть popup в установленной тестовой версии.
  2. Смоделировать отказ получения данных и увидеть ошибку.
  3. Закрыть окно во время ожидания ответа.
  4. Открыть снова и получить актуальное состояние.
  5. Переключить вкладку и проверить, что UI не показывает старый контекст как новый.

Не путайте консоли: у popup, content script и service worker разные точки наблюдения. Ошибка в одном контексте может не появиться в другом. Зафиксируйте короткую цепочку диагностических ID без содержимого страниц и секретов. Если UI успевает отобразиться только под инспектором, проверьте зависимость от времени и жизненного цикла, не добавляя произвольную задержку как окончательное решение.

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

Проверенные источники