Haz un seguimiento del progreso de tu migración
Las siguientes listas de tareas te ayudarán a hacer un seguimiento de tu trabajo de migración. Definen las tareas que se deben completar con enlaces a instrucciones. En términos generales, el trabajo de migración se divide en cinco categorías, como se describe en Resumen de migración.
Cómo actualizar el manifiesto
El archivo manifest.json requiere un formato ligeramente diferente para Manifest V3 y 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 tratan con las tareas de migración que los requieren.
- Cambia el número de versión del manifiesto.
- Actualiza los permisos de host.
- Actualiza los recursos accesibles desde la Web.
Migra a un service worker
Un service worker reemplaza el fondo o la página de eventos de la extensión para garantizar que el código del fondo 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 las secuencias de comandos en segundo plano y los service workers de extensión.
- Actualiza el campo "segundo plano" en el manifiesto
- Traslada las llamadas del DOM y las ventanas a un documento fuera de pantalla
- Convierte localStorage en chrome.storage.local
- Registra objetos de escucha de forma síncrona
- Reemplaza las llamadas a
XMLHttpRequest()porfetch()globales. - Estados persistentes
- Cómo convertir temporizadores en alarmas
- Mantener vivo 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 acciones del navegador y de la página por acciones
- Reemplaza las funciones que esperan un contexto en segundo plano de Manifest V2.
- Reemplaza devoluciones de llamada con promesas
- Reemplaza las APIs no compatibles
Reemplaza objetos de escucha de solicitudes web de bloqueo
En lugar de leer de manera programática las solicitudes de red y modificarlas (como lo hiciste en Manifest V2), tu extensión especifica reglas que describen acciones para realizar cuando se cumple un conjunto determinado de condiciones.
Después de completar los puntos anteriores, te recomendamos revisar algunos casos de uso comunes:
Mejora la seguridad de las extensiones
Se deben realizar cambios para mejorar la seguridad de las extensiones. Esto incluye quitar el código alojado de forma remota, que ya no se admite.
- Quita la ejecución de strings arbitrarias.
- Quita el código alojado de forma remota
- Actualiza la política de seguridad del contenido.
- Quita los valores de la política de seguridad del contenido no compatibles
Publica tu extensión de Manifest V3
Después de realizar la conversión a la versión 3 del manifiesto, es momento de lanzar la extensión en Chrome Web Store. Según los cambios realizados, considera realizar un lanzamiento gradual. Este enfoque te permite asegurarte de que tu extensión funcione según lo esperado con un público limitado antes de lanzarla a toda la base de usuarios.