Два одинаковых console.log ещё не доказывают двойную инъекцию в один документ. Один content script мог запуститься в главном frame и iframe, в старом и новом документе SPA-навигации либо одновременно из manifest.json и chrome.scripting.executeScript. Сначала добавьте координаты запуска, потом убирайте причину.
Самая частая ремонтопригодная ошибка — один файл объявлен статически в content_scripts, а service worker снова вводит его после tabs.onUpdated или клика. Оставьте один механизм для одного сценария. Динамическая регистрация нужна, когда match patterns меняются во время работы; executeScript — для разового действия.
Четыре случая выглядят одинаково только в консоли
| Источник двух запусков | Отличительный признак | Исправление |
|---|---|---|
| manifest + executeScript | Один documentId и frameId | Удалить второй путь |
| allFrames=true | Разные frameId | Ограничить main frame или принять многократность |
| Повторная навигация | Новый documentId | Очищать состояние на каждый документ |
| Двойной listener внутри одного запуска | Один boot, два callback | Симметричный remove/AbortController |
| Несколько похожих расширений | Разный extension id | Проверить профиль и сборку |
Chrome определяет main frame как frameId 0; дочерние фреймы получают положительные значения. documentId меняется вместе с документом и точнее отделяет новую навигацию от повторного сообщения старой страницы. URL без этих полей недостаточен: один адрес может жить в нескольких фреймах и вкладках.
Фон собирает паспорт каждого boot
// content-script.js
chrome.runtime.sendMessage({ type: "CONTENT_BOOT", href: location.href });
// service-worker.js
chrome.runtime.onMessage.addListener((msg, sender) => {
if (msg.type !== "CONTENT_BOOT") return;
console.info({ tabId: sender.tab?.id, frameId: sender.frameId,
documentId: sender.documentId, url: sender.url });
});
scripts = await chrome.scripting.getRegisteredContentScripts();В production-лог не отправляют полный URL с query и fragment: там бывают токены и пользовательские данные. Для диагностики достаточно origin, нормализованного path, версии расширения и идентификаторов контекста. In-memory набор boot keys полезен в тесте, но service worker может перезапуститься, поэтому он не является постоянной гарантией.
Сначала инвентаризация, затем guard
- Найти файл во всех content_scripts манифеста.
- Проверить registerContentScripts и вывести зарегистрированные id.
- Найти каждый executeScript с этим файлом или функцией и его target.
- Сравнить allFrames, frameIds, match_about_blank и match_origin_as_fallback.
- Воспроизвести один reload при открытой service-worker console.
- Сопоставить boot по tabId, frameId и documentId.
registerContentScripts с уже существующим id отклоняется, а не создаёт молча второй динамический id. Но это не исключает параллельную статическую декларацию или programmatic injection. Список зарегистрированных скриптов показывает только динамический слой, поэтому manifest всё равно проверяется отдельно.
Инициализация допускает повторный вызов
Даже после удаления второй инъекции полезно сделать setup повторяемым. Перед добавлением панели найдите существующий root по namespaced id; перед подпиской снимите прежний listener либо храните AbortController; сетевой side effect защищайте operation key на backend. Один DOM-флаг не заменяет анализ frames и может быть удалён страницей.
- Создание UI возвращает существующий root вместо второго.
- MutationObserver отключается при teardown и не накапливается.
- Сообщение READY имеет version и не запускает повторную загрузку данных.
- Обработчик клика добавляется один раз на текущий document.
- Backend не выполняет два изменения из-за двух одинаковых extension requests.
SPA и полноценная навигация требуют разных хуков
При history.pushState документ остаётся тем же, поэтому статический content script заново не внедряется сам по себе. Если расширение должно реагировать на маршрут, наблюдайте осознанный navigation signal и обновляйте существующий UI. При полном переходе появляется новый documentId и инициализация начинается заново — это ожидаемо.
Фреймы не должны делить одну глобальную переменную
Content scripts работают в isolated world, причём у каждого frame свой контекст. window-флаг в main frame не остановит код внутри iframe. Если задача нужна только верхней странице, не включайте allFrames. Если нужны все фреймы, ключуйте сообщения и побочные эффекты по frameId/documentId.
Регресс проверяет не только F5
Прогоните обычную загрузку, iframe, SPA-переход, back/forward cache, обновление расширения и повторное пробуждение service worker. Ожидаемое число boot фиксируется для каждого случая заранее. Для разбора пришлите manifest без секретов, места регистрации и executeScript, версию Chrome и две строки паспорта запуска — содержимое страницы не требуется.