API браузеров и совместимость
Начните с перечня вызовов API расширения. Для каждого метода и события запишите нужные версии браузеров и проверьте данные о совместимости. В руководстве MDN по кроссбраузерным расширениям перечислены различия в охвате API, пространствах имён, асинхронных вызовах и выполнении скриптов.
Сверьте использование browser.* и chrome.* с выбранными версиями. Укажите, ожидает ли код Promise или callback, в том числе в ответах обработчиков сообщений. Поддержка пространства имён ещё не определяет поведение каждого метода и события.
Если функция недоступна, заранее определите альтернативное поведение. MDN рекомендует проверять наличие возможностей во время выполнения, когда от этого зависит выбор реализации.
При переносе из Chrome в Edge используйте инструкцию Microsoft: она начинается со сверки используемых API со списком поддерживаемых в Edge. Эта проверка нужна и при общем коде для браузеров.
Манифест и разрешения
Проверьте manifest.json каждого браузерного пакета. Справочник MDN по манифесту описывает ключи метаданных, разрешений и функций. Для каждого разрешения и области доступа к сайтам укажите действие продукта, которому они нужны.
Отдельно проверьте фоновое выполнение. MDN описывает extension service workers в Manifest V3 Chrome и фоновые страницы Firefox. Сверяйте конфигурацию и поведение с выбранными браузерами.
В инструкции переноса Microsoft также указаны удаление update_url, замена упоминаний Chrome в названии и описании для Edge и тестирование пакета через локальную установку. Добавьте эти конкретные проверки к перечню API.
Пакет и карточка магазина каждого браузера — отдельные материалы выпуска. MDN описывает раздельную подачу в магазины; успешный локальный тест не подтверждает результат модерации.
Что меняется в манифесте Chrome и Firefox
Учебные фрагменты для Manifest V3. В примере выбраны Chrome 121 и новее, Firefox 121 и новее. Это части манифестов для объяснения фоновой конфигурации, а не стек или выполненный проект Extcorp.
Для пакета Chrome:
{
"manifest_version": 3,
"background": {
"service_worker": "background.js"
}
}
Для пакета Firefox:
{
"manifest_version": 3,
"background": {
"scripts": ["background.js"]
}
}
В справочнике MDN по background описаны service worker Chrome и фоновые скрипты Firefox. Там же указаны изменения начиная с версии 121 в обработке ключей для другой фоновой среды. Каждый фрагмент выше задаёт только свою среду.
Проверьте оба пакета по сценарию сохранения настройки из следующего раздела. Для каждого запишите фактическую версию браузера и результат.
Как составить матрицу браузерной приёмки
Выберите один полезный сценарий для всех браузеров. Например: сохранить настройку, закрыть панель, открыть её снова и убедиться, что значение сохранилось. Это пример проверки, а не описание выполненного проекта.
Заполните матрицу:
| Браузер и версия | Проверки совместимости | Запись о приёмке |
|---|---|---|
| Chrome: указать версию | Вызовы API, разрешения, фоновое поведение и манифест пакета | Сценарий, ожидаемое поведение, наблюдаемый результат и подтверждение |
| Edge: указать версию | Поддержка API, разрешения, пункты переноса и локально установленный пакет | Тот же сценарий, ожидаемое поведение, наблюдаемый результат и подтверждение |
| Firefox: указать версию | Охват API, асинхронные вызовы, разрешения и конфигурация фона | Тот же сценарий, ожидаемое поведение, наблюдаемый результат и подтверждение |
Добавьте строки для других нужных версий. Сохраняйте сборку расширения и среду тестирования рядом с результатом. При различиях укажите затронутое действие и согласованную альтернативу, чтобы проверку можно было повторить.
Подготовьте ТЗ на разработку
Перенесите перечень API и матрицу в требования:
- Опишите основное действие пользователя и текущее состояние проекта.
- Перечислите браузеры и версии для приёмки.
- Укажите зависимости от API, разрешения, доступ к сайтам и интеграции.
- Задайте ожидаемое поведение, альтернативы и подтверждения для каждой проверки.
- Разделите изменения кода, подготовку пакетов и ответственность за подачу в магазины.
В брифе на разработку расширения есть структура для копирования. Если выбор между готовым продуктом и новой разработкой ещё открыт, используйте сравнение покупки и разработки.
В рамках разработки браузерных расширений Extcorp рассматривает нужные браузеры, разрешения, интеграции и текущее состояние проекта. Пришлите требования и матрицу, чтобы обсудить состав работ.
Обсудить разработку расширения
Extcorp не связан с Google, Microsoft и Mozilla.

