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.