Realiza un seguimiento del progreso de tu migración
Las siguientes listas de verificación te ayudan a hacer un seguimiento de tu trabajo de migración. Definen las tareas que se deben completar con vínculos a las instrucciones. El trabajo de migración se divide en cinco categorías generales, como se describe en el Resumen de la migración.
Actualiza el manifiesto
El archivo manifest.json requiere un formato ligeramente diferente para Manifest V3 que para Manifest V2. En esta página, se describen los cambios que solo afectan el archivo manifest.json. Sin embargo, muchos de los cambios en las secuencias de comandos y las páginas también requieren cambios en el manifiesto. Esos cambios se incluyen en las tareas de migración que los requieren.
- Cambia el número de versión del manifiesto.
- Actualiza los permisos del host.
- Actualiza los recursos accesibles desde la Web.
Migra a un service worker
Un service worker reemplaza la página de eventos o de segundo plano de la extensión para garantizar que el código de segundo plano permanezca fuera del subproceso principal. Esto permite que las extensiones se ejecuten solo cuando sea necesario, lo que ahorra recursos.
Antes de comenzar, lee sobre las diferencias entre los scripts de segundo plano y los service workers de extensiones.
- Actualiza el campo "background" en el manifiesto
- Cómo mover llamadas de DOM y de ventanas a un documento fuera de pantalla
- Cómo convertir localStorage a chrome.storage.local
- Cómo registrar objetos de escucha de forma síncrona
- Reemplaza las llamadas a
XMLHttpRequest()porfetch()globales. - Persistir estados
- Cómo convertir temporizadores en alarmas
- Mantén activo el service worker (en casos excepcionales)
Actualiza las llamadas a la API
Algunas funciones deben reemplazarse por equivalentes de Manifest V3. Otros deben quitarse por completo.
- Reemplaza
tabs.executeScript()porscripting.executeScript(). - Reemplaza
tabs.insertCSS()ytabs.removeCSS()porscripting.insertCSS()yscripting.removeCSS(). - Reemplaza las acciones del navegador y las acciones de la página por Acciones
- Reemplaza las funciones que esperan un contexto en segundo plano de Manifest V2.
- Reemplaza las devoluciones de llamada por promesas
- Reemplaza las APIs no compatibles
Reemplaza los objetos de escucha de solicitudes web de bloqueo
En lugar de leer solicitudes de red y modificarlas de forma programática (como lo hiciste en Manifest V2), tu extensión especifica reglas que describen las acciones que se deben realizar cuando se cumple un conjunto determinado de condiciones.
Después de completar los elementos anteriores, es posible que desees revisar algunos casos de uso comunes:
Mejora la seguridad de las extensiones
Se requieren cambios para mejorar la seguridad de las extensiones. Esto incluye quitar el código alojado de forma remota, que ya no es compatible.
- Se quitó la ejecución de cadenas arbitrarias.
- Quita el código alojado de forma remota
- Actualiza la política de seguridad del contenido.
- Quita los valores no admitidos de la política de seguridad del contenido
Publica tu extensión de Manifest V3
Después de convertirla a la versión 3 del manifiesto, es hora de lanzar tu extensión en Chrome Web Store. Según los cambios realizados, considera una implementación gradual. Este enfoque te permite asegurarte de que tu extensión funcione según lo previsto con un público limitado primero, antes de lanzarla para toda la base de usuarios.