Сначала запишите, кому адресовано сообщение: контексту расширения или content script конкретной вкладки. Затем проверьте, существует ли получатель в текущем документе. Активная вкладка могла смениться, страница — перейти на другой адрес, а popup — закрыться раньше ответа. Для диагностики начните с безвредного запроса состояния, а не с изменения содержимого страницы.
Chrome документирует runtime.sendMessage и tabs.sendMessage для разовых сообщений между контекстами расширения, включая content scripts. Источник проверен 23 октября 2026 года. Одинаковое имя операции не выбирает вкладку автоматически. Разделите адресацию, приём и прикладной результат в журнале, чтобы «отправили сообщение» не означало «операция завершена».
Четыре ситуации выглядят одинаково только в popup
| Ситуация | Что подтвердить |
|---|---|
| Нет получателя | Content script реально подключён к документу |
| Получатель в другой вкладке | Выбор tabId и соответствующего контекста |
| Документ уже сменился | Актуальность адресата после навигации |
| Ответу некуда прийти | Жизненный цикл popup и место хранения результата |
Стабильная операция переживает короткую жизнь окна
Условный запрос состояния:
requestId -> тип операции + разрешённые данные
адресат -> выбранная вкладка и ожидаемый документ
приём -> проверка формата и отправителя
результат -> связать с requestId
popup закрыт -> сохранить допустимый итог вне его памяти
повтор открытия -> запросить состояние, не исполнить действие зановоНе пытайтесь лечить отсутствие получателя бесконечной инъекцией одного и того же скрипта. Сначала проверьте правила подключения и доступ к странице. Повторный запуск может размножить слушателей и обработать следующую команду несколько раз. Инициализация должна быть управляемой; подключение к уже открытой странице — отдельный разрешённый сценарий.
Для страниц с фреймами определите, какой документ владеет нужным действием. Отправка во все доступные фреймы без контракта может вернуть несколько ответов или изменить лишние элементы. Не считайте первое полученное сообщение гарантированным результатом основного документа. В собственном протоколе достаточно ограниченного контекста и безопасного подтверждения.
Сообщение от content script не должно давать странице универсальные полномочия расширения. Проверяйте отправителя, тип и допустимые данные; не принимайте произвольную команду или URL для выполнения с повышенным доступом. Ответ должен содержать только необходимые поля. Вывод текста в popup не должен интерпретировать недоверенные данные как HTML.
Смена вкладки проверяет адресацию
- Открыть разрешённую тестовую страницу и получить безвредный ответ.
- Сменить вкладку между открытием popup и отправкой.
- Перейти на новый документ во время ожидания.
- Закрыть popup до результата и открыть снова.
- Повторить requestId и проверить отсутствие повторного эффекта.
Для асинхронного ответа используйте контракт своей версии API и корректно обрабатывайте отказ Promise или отсутствие ответа. Таймаут UI не доказывает, что действие не произошло. Операция с последствиями должна иметь состояние и защиту от повтора отдельно от транспорта messaging. Не подменяйте эту задачу случайной задержкой перед каждым вызовом.
Для разбора подготовьте схему контекстов, обезличенные ID запроса и адресата и отметки приёма/ответа. Парсить чужую страницу или собирать её данные для такого теста не требуется. Исправление видно, когда сообщение достигает нужного документа, а закрытие короткоживущего интерфейса не теряет уже выполненный результат.