El ciclo de vida de un service worker de extensiones

Los service workers de la extensión responden a los eventos estándar de service workers y a los eventos en los espacios de nombres de la extensión. 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 no empaquetada con la página chrome://extensions. Ocurren tres eventos, en este orden:

1. install
2. onInstall
3. activate

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 encuentra 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, ya que no hay nada comparable a la recarga de 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 invoca ningún evento de Service Worker.

Inactividad 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 service worker entró en modo inactivo, un evento entrante lo reactivará. Sin embargo, debes diseñar tu service worker para que sea resistente a la finalización inesperada.

Para optimizar el consumo de recursos de tu extensión, evita mantener activo tu service worker de forma indefinida si es posible. Prueba tus extensiones para asegurarte de que no lo estés haciendo sin querer.

Persiste los datos en lugar de usar variables globales

Si se cierra el trabajador de servicio, se perderán todas las variables globales que hayas establecido. En lugar de usar variables globales, guarda los valores en el almacenamiento. Se mostrarán tus opciones.

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 quita cuando un usuario borra la caché web.

API de IndexedDB

Una API de bajo nivel para el almacenamiento del lado del cliente de datos estructurados, incluidos archivos y BLOBs. Esta API proporciona elementos primitivos para crear almacenamiento y recuperación de datos transaccionales. Aunque esta API suele ser demasiado complicada para algunos casos de uso, varias soluciones de almacenamiento de terceros se basan 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 service workers 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 cómo lo es. Para obtener más información, consulta The Offline Cookbook. A menos que específicamente estés enviando solicitudes de red a través del controlador de recuperación, debes usar chrome.storage.

Cómo elegir una versión mínima de Chrome

Desde el lanzamiento de Manifest V3, realizamos varias mejoras en la vida útil de los service workers. Esto significa que, si tu extensión de Manifest V3 admite versiones anteriores de Chrome, deberás tener en cuenta algunas condiciones. Si estas condiciones no afectan tu extensión, puedes continuar con 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 con 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 detalles.

Chrome 118

Las sesiones de depurador activas creadas con la API de chrome.debugger ahora mantienen activo el service worker. Esto evita que los service workers agoten el tiempo de espera durante las llamadas a esta API.

Chrome 116

En Chrome 116, se introdujeron las siguientes mejoras en el ciclo de vida del Service Worker:

• Las conexiones WebSocket activas ahora extienden la vida útil de los service workers de la extensión. Enviar o recibir mensajes a través de un objeto WebSocket en un service worker de extensión restablece el temporizador de inactividad del service worker.

• Se permite que las APIs de extensiones adicionales superen el período de espera de cinco minutos para los service workers de extensiones. Estas APIs muestran un mensaje para el usuario y, por lo tanto, pueden tardar más de cinco minutos en resolverse. Se incluyen desktopCapture.chooseDesktopMedia(), identity.launchWebAuthFlow(), management.uninstall() y permissions.request().

Chrome 114

Enviar un mensaje con mensajería de larga duración mantiene activo el service worker. Abrir un puerto ya no restablece los temporizadores.

Chrome 110

Las llamadas a la API de extensión restablecen los temporizadores. Antes de esto, solo los controladores de eventos en ejecución mantenían activo un service worker. Los eventos que se pusieron en cola, pero para los que no se llamó a un controlador, no provocarían un restablecimiento.

Chrome 109

Los mensajes enviados desde un documento fuera de la pantalla restablecen los temporizadores.

Chrome 105

La conexión a un host de mensajería nativa con chrome.runtime.connectNative() mantendrá activo un service worker. Si el proceso del host falla o se cierra, el puerto se cierra y el service worker 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.