Добавьте в тестовую сборку простую статическую метку 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. Если пользователь закрыл окно после запуска разрешённой операции, её состояние должно иметь понятного владельца и восстанавливаться по идентификатору. При повторном открытии покажите результат или ожидание, а не автоматически запускайте действие ещё раз. Для простого чтения настроек достаточно повторного безопасного запроса.
Проверяйте короткую жизнь окна намеренно
- Открыть popup в установленной тестовой версии.
- Смоделировать отказ получения данных и увидеть ошибку.
- Закрыть окно во время ожидания ответа.
- Открыть снова и получить актуальное состояние.
- Переключить вкладку и проверить, что UI не показывает старый контекст как новый.
Не путайте консоли: у popup, content script и service worker разные точки наблюдения. Ошибка в одном контексте может не появиться в другом. Зафиксируйте короткую цепочку диагностических ID без содержимого страниц и секретов. Если UI успевает отобразиться только под инспектором, проверьте зависимость от времени и жизненного цикла, не добавляя произвольную задержку как окончательное решение.
Для разбора подготовьте минимальный popup с меткой, manifest установленного пакета и обезличенную ошибку первого неуспешного этапа. Исправление подтверждено, когда новое окно каждый раз даёт содержимое, загрузку или объяснимый отказ. Пользователь не должен угадывать, пустой экран означает отсутствие данных, ожидание или поломку расширения.