Контрольный список миграции манифеста V3

Следите за ходом миграции

Примечание. Манифест V3 обычно поддерживается в Chrome 88 и более поздних версиях. Информацию о поддержке функций расширений, добавленных в более поздних версиях Chrome, см. в справочной документации API . Если вашему расширению требуется определенный API, вы можете указать минимальную версию Chrome в файле манифеста.

Приведенные ниже контрольные списки помогут вам отслеживать вашу работу по миграции. Они определяют задачи, которые необходимо выполнить, со ссылками на инструкции. Миграционная работа в общих чертах разделена на пять категорий, как описано в Кратком обзоре миграции .

Обновить манифест

Для файла manifest.json требуется немного другой формат для Manifest V3, чем для Manifest V2. На этой странице описаны изменения, которые затрагивают только файл manifest.json . Но многие изменения в скриптах и ​​страницах также требуют внесения изменений в манифест. Эти изменения охватываются задачами миграции, которые их требуют.

• Измените номер версии манифеста .
• Обновите разрешения хоста .
• Обновите доступные веб-ресурсы .

Миграция на сервисного работника

Работник службы заменяет фон расширения или страницу событий, чтобы гарантировать, что фоновый код не попадает в основной поток. Это позволяет расширениям запускаться только при необходимости, экономя ресурсы.

Прежде чем начать, прочтите о различиях между фоновыми сценариями и работниками служб расширений .

• Обновите поле «фон» в манифесте.
• Переместите DOM и вызовы окон в документ за кадром.
• Преобразовать localStorage в chrome.storage.local
• Регистрация слушателей синхронно
• Замените вызовы XMLHttpRequest() на глобальную fetch() .
• Сохраняться состояния
• Преобразование таймеров в будильники
• Поддерживайте работоспособность сервисного работника (в исключительных случаях)

Обновление вызовов API

Некоторые функции необходимо заменить эквивалентами Manifest V3. Остальные необходимо удалить полностью.

• Замените tabs.executeScript() на scripting.executeScript() .
• Замените tabs.insertCSS() и tabs.removeCSS() на scripting.insertCSS() и scripting.removeCSS() .
• Замените действия браузера и действия страницы действиями
• Замените функции, ожидающие фонового контекста Manifest V2 .
• Замените обратные вызовы обещаниями
• Замените неподдерживаемые API

Заменить блокирующие прослушиватели веб-запросов

Вместо программного чтения сетевых запросов и их изменения (как вы делали в Манифесте V2), ваше расширение определяет правила, описывающие действия, которые необходимо выполнить при выполнении заданного набора условий.

• Обновить разрешения
• Создание декларативных правил сетевых запросов

После выполнения вышеперечисленных пунктов вы можете рассмотреть несколько распространенных случаев использования :

• Заблокировать один URL-адрес
• Перенаправление с несколькими URL-адресами
• Блокировать файлы cookie

Повышение безопасности расширений

Изменения необходимы для повышения безопасности расширений. Сюда входит удаление удаленно размещенного кода, который больше не поддерживается.

• Удалить выполнение произвольных строк .
• Удаление удаленно размещенного кода
• Обновите политику безопасности контента .
• Удалить неподдерживаемые значения политики безопасности контента.

Опубликуйте расширение Manifest V3.

После преобразования в манифест версии 3 пришло время опубликовать расширение в Интернет-магазине Chrome. В зависимости от внесенных изменений рассмотрите возможность поэтапного развертывания. Такой подход позволяет вам убедиться, что ваше расширение работает должным образом сначала с ограниченной аудиторией, прежде чем выпускать его для всей базы пользователей.

• Опубликуйте бета-версию .
• Постепенно внедряйте свой релиз .
• Запланируйте время рассмотрения .
• Дополнительные советы .