Los service workers de extensiones responden a los eventos de service worker estándar y a los eventos en los espacios de nombres de las extensiones. Se presentan juntos porque, a menudo, un tipo sigue a otro durante el uso de una extensión.
Instalación
La instalación se produce cuando el usuario instala o actualiza un service worker desde Chrome Web Store o cuando carga o actualiza una extensión sin empaquetar usando la página chrome://extensions
. A continuación, ocurren tres eventos en el siguiente orden.
ServiceWorkerRegistration.install
El primer evento que se activa durante la instalación es el evento install de un service worker web.
chrome.runtime.onInstalled
A continuación, se muestra el evento onInstalled
de la extensión, que se activa cuando se instala la extensión (no el service worker) por primera vez, cuando se actualiza la extensión a una versión nueva y cuando se actualiza Chrome a una versión nueva. Usa este
evento para establecer un estado o para la inicialización única, como un menú contextual.
chrome.runtime.onInstalled.addListener((details) => {
if(details.reason !== "install" && details.reason !== "update") return;
chrome.contextMenus.create({
"id": "sampleContextMenu",
"title": "Sample Context Menu",
"contexts": ["selection"]
});
});
ServiceWorkerRegistration.active
Por último, se activa el evento activate del service worker. Ten en cuenta que, a diferencia de los service workers web, este evento se activa inmediatamente después de la instalación de una extensión porque no hay nada comparable a volver a cargar una página en una extensión.
Inicio de la extensión
Cuando se inicia un perfil de usuario, se activa el evento chrome.runtime.onStartup
, pero no se invocan eventos de service worker.
Inactivo y apagado
Normalmente, Chrome finaliza un service worker cuando se cumple una de las siguientes condiciones:
- Después de 30 segundos de inactividad Recibir un evento o llamar a una API de extensión restablece este temporizador.
- Cuando una sola solicitud, como un evento o una llamada a la API, tarda más de 5 minutos en procesarse.
- Cuando una respuesta de
fetch()
tarda más de 30 segundos en llegar.
Los eventos y las llamadas a las APIs de extensión restablecen estos temporizadores y, si el trabajador de servicio está inactivo, un evento entrante los reactivará. Sin embargo, debes diseñar tu service worker para que sea resiliente en caso de una finalización inesperada.
Para optimizar el consumo de recursos de tu extensión, evita mantener el trabajador de servicio activo de forma indefinida si es posible. Prueba tus extensiones para asegurarte de no estar haciendo esto de forma involuntaria.
Conserva los datos en lugar de usar variables globales
Se perderán todas las variables globales que configures si se cierra el trabajador de servicio. En lugar de usar variables globales, guarda los valores en el almacenamiento. A continuación, se indican tus opciones. Ten en cuenta que la API de Web Storage no está disponible para los service workers de extensiones.
- API de chrome.storage
- Una API de extensión que ofrece varios tipos de almacenamiento: local, de sesión, administrado (dominio) y de sincronización. Esta API almacena objetos JSON identificados y recuperados con claves definidas por el desarrollador. Este tipo de almacenamiento no se quitará cuando un usuario borre la caché web.
- API de IndexedDB
- Una API de bajo nivel para el almacenamiento del cliente de datos estructurados, incluidos archivos y BLOB. Esta API proporciona primitivas para crear almacenamiento y recuperación de datos transaccionales. Si bien esta API suele ser demasiado complicada para casos de uso simples, se compilan varias soluciones de almacenamiento de terceros en ella.
- API de CacheStorage
- Un mecanismo de almacenamiento persistente para pares de objetos Request y Response. Esta API se diseñó específicamente para los trabajadores de servicios web y se usa para recuperar datos de un extremo. Existen varias formas de usar esta API según si es fundamental que los usuarios vean datos actualizados y qué tan importante es. Para obtener más información, consulta The Offline Cookbook. A menos que dirijas solicitudes de red mediante proxy de forma específica a través del controlador de recuperación, debes usar
chrome.storage
.
Elige una versión mínima de Chrome
Desde el lanzamiento de Manifest V3, hemos realizado varias mejoras en la vida útil de los service workers. Esto significa que, si tu extensión de Manifest V3 es compatible con versiones anteriores de Chrome, debes tener en cuenta algunas condiciones. Si estas condiciones no afectan a tu extensión, puedes pasar a la siguiente sección. Si es así, considera especificar una versión mínima de Chrome en tu manifiesto.
Chrome 120
Ahora, las alarmas se pueden configurar en un período mínimo de 30 s para que coincidan con el ciclo de vida del trabajador de servicio. Consulta chrome.alarms
para obtener más información.
Chrome 118
Las sesiones de depurador activas creadas con la API de chrome.debugger
ahora mantienen el trabajador de servicio activo. Esto evita que los trabajadores del servicio se agoten durante las llamadas a esta API.
Chrome 116
Chrome 116 introdujo las siguientes mejoras en la vida útil de los service workers:
Las conexiones
WebSocket
activas ahora extienden la vida útil de los service workers de extensiones. Enviar o recibir mensajes a través de unWebSocket
en un trabajador de servicio de extensión restablece el temporizador inactivo del trabajador de servicio.Las APIs de extensión adicionales pueden superar el tiempo de espera de cinco minutos para los service workers de extensiones. Estas APIs muestran un mensaje para el usuario y, por lo tanto, es posible que demoren más de cinco minutos en resolverse. Entre los mencionados, se incluyen
desktopCapture.chooseDesktopMedia()
,identity.launchWebAuthFlow()
,management.uninstall()
ypermissions.request()
.
Chrome 114
Enviar un mensaje con mensajería de larga duración mantiene activo el servicio en primer plano. Anteriormente, abrir un puerto restablecía los temporizadores, pero no enviar un mensaje. Abrir un puerto ya no restablece los temporizadores.
Chrome 110
Las llamadas a la API de la extensión restablecen los temporizadores. Antes de esto, solo los controladores de eventos en ejecución mantenían en funcionamiento un service worker. Los eventos que se hayan puesto en cola, pero para los que no se haya llamado a un controlador, no causarán un restablecimiento.
Chrome 109
Los mensajes enviados desde un documento fuera de la pantalla restablecen los temporizadores.
Chrome 105
Si te conectas a un host de mensajería nativa mediante chrome.runtime.connectNative()
, se mantendrá activo un service worker. Si el proceso del host falla o se cierra, el puerto se cerrará y el trabajador de servicio finalizará después de que se completen los temporizadores. Para evitar esto, llama a chrome.runtime.connectNative()
en el controlador de eventos onDisconnect del puerto.