Следите за ходом миграции
Приведенные ниже контрольные списки помогут вам отслеживать вашу работу по миграции. Они определяют задачи, которые необходимо выполнить, со ссылками на инструкции. Миграционная работа в общих чертах разделена на пять категорий, как описано в Кратком обзоре миграции .
Обновить манифест
Для файла 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), ваше расширение определяет правила, описывающие действия, которые необходимо выполнить при выполнении заданного набора условий.
После выполнения вышеперечисленных пунктов вы можете рассмотреть несколько распространенных случаев использования :
Повышение безопасности расширений
Изменения необходимы для повышения безопасности расширений. Сюда входит удаление удаленно размещенного кода, который больше не поддерживается.
- Удалить выполнение произвольных строк .
- Удаление удаленно размещенного кода
- Обновите политику безопасности контента .
- Удалить неподдерживаемые значения политики безопасности контента.
Опубликуйте расширение Manifest V3.
После преобразования в манифест версии 3 пришло время опубликовать расширение в Интернет-магазине Chrome. В зависимости от внесенных изменений рассмотрите возможность поэтапного развертывания. Такой подход позволяет вам убедиться, что ваше расширение работает должным образом сначала с ограниченной аудиторией, прежде чем выпускать его для всей базы пользователей.