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

Отслеживайте ход миграции.

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

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

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

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

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

Перейдите на работу в сфере услуг.

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

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

• Обновите поле "background" в манифесте.
• Переместите вызовы 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.

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

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

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

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

• Заблокировать один URL-адрес
• Redirect-multiple-urls
• Блокировка файлов cookie

Улучшить безопасность расширений

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

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

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

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

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