Cómo trabajar con service workers

En este codelab, se muestra cómo registrar un service worker desde tu aplicación web y usar Chrome DevTools para observar su comportamiento. También se describen algunas técnicas de depuración que pueden resultarte útiles cuando trabajes con service workers.

Familiarízate con el proyecto de ejemplo

Los archivos del proyecto de ejemplo más relevantes para este codelab son los siguientes:

  • register-sw.js comienza vacío, pero contendrá el código que se usó para registrar el trabajador de servicio. Ya se cargan a través de una etiqueta <script> dentro del index.html del proyecto.
  • service-worker.js también está vacío. Es el archivo que contendrá el trabajador de servicio de este proyecto.

Agrega el código de registro del service worker

No se usará un service worker (incluso uno vacío, como el archivo service-worker.js actual), a menos que primero se registre. Puedes hacerlo llamando a:

navigator.serviceWorker.register(
  '/service-worker.js'
)

dentro del archivo register-sw.js.

Sin embargo, antes de agregar ese código, debes tener en cuenta algunos puntos.

Primero, no todos los navegadores admiten service workers. Esto es especialmente cierto para las versiones anteriores de navegadores que no se actualizan automáticamente. Por lo tanto, se recomienda llamar a navigator.serviceWorker.register() de forma condicional, después de verificar si navigator.serviceWorker es compatible.

En segundo lugar, cuando registras un service worker, el navegador ejecuta el código del archivo service-worker.js y podría comenzar a descargar URLs para propagar datos en caché, según el código que se encuentre en los controladores de eventos install y activate del service worker.

Ejecutar código adicional y descargar recursos puede agotar recursos valiosos que tu navegador podría usar para mostrar la página web actual. Para evitar esta interferencia, se recomienda retrasar el registro de un service worker hasta que el navegador termine de renderizar la página actual. Una forma conveniente de aproximarse a esto es esperar hasta que se active el evento window.load.

Combinando esos dos puntos, agrega este código de registro del trabajador de servicio de uso general a tu archivo register-sw.js:

if ('serviceWorker' in navigator) {
  window.addEventListener('load', () => {
    navigator.serviceWorker.register('/service-worker.js');
  });
}

Agrega algún código de registro de service worker

Tu archivo service-worker.js es donde normalmente iría toda la lógica para la implementación del service worker. Usarías una combinación de los eventos de ciclo de vida del service worker, la API de Cache Storage y el conocimiento sobre el tráfico de red de tu app web para crear un service worker perfectamente diseñado, listo para controlar todas las solicitudes de tu app web.

Pero… eso es todo por ahora. En esta etapa, el objetivo es observar varios eventos de service worker, y familiarizarte con el uso de las Herramientas para desarrolladores de Chrome a fin de depurar su estado.

Para ello, agrega el siguiente código a service-worker.js, que registrará mensajes en la consola de Herramientas para desarrolladores en respuesta a varios eventos (pero no hará mucho más):

self.addEventListener('install', (event) => {
  console.log('Inside the install handler:', event);
});

self.addEventListener('activate', (event) => {
  console.log('Inside the activate handler:', event);
});

self.addEventListener(fetch, (event) => {
  console.log('Inside the fetch handler:', event);
});

Familiarízate con el panel Service Workers en Herramientas para desarrolladores

Ahora que agregaste el código a los archivos register-sw.js y service-worker.js, es hora de visitar la versión publicada del proyecto de ejemplo y observar el service worker en acción.

  • Para obtener una vista previa del sitio, presiona Ver app. Luego, presiona Pantalla completapantalla completa.
  • Presiona `Control + Mayúsculas + J` (o `Command + Option + J` en Mac) para abrir Herramientas para desarrolladores.
  • Haz clic en la pestaña Consola.

Deberías ver un mensaje de registro similar al siguiente, que muestra que se instaló y activó el trabajador de servicio:

Muestra que el service worker está instalado y activado.

Luego, visita la pestaña Applications y selecciona el panel Service Workers. Deberías ver un resultado similar al siguiente:

Muestra los detalles del service worker en el panel del service worker.

Esto te indica que hay un service worker con una URL de origen de service-worker.js para la app web solar-donkey.glitch.me, que está activado y en ejecución. También te indica que, actualmente, hay un cliente (pestaña abierta) que controla el service worker.

Puedes usar los vínculos de este panel, como Unregister o stop, para realizar cambios en el trabajador de servicio registrado actualmente con fines de depuración.

Activa el flujo de actualización del trabajador de servicio

Uno de los conceptos clave que debes comprender cuando desarrollas con service workers es la idea de un flujo de actualización.

Después de que los usuarios visiten una app web que registre un trabajador de servicio, terminarán con el código de la copia actual de service-worker.js instalada en su navegador local. Pero ¿qué sucede cuando actualizas la versión de service-worker.js que está almacenada en tu servidor web?

Cuando un visitante recurrente regresa a una URL que está dentro del alcance de un trabajador de servicio, el navegador solicitará automáticamente el service-worker.js más reciente y comprobará si hay cambios. Si algo en la secuencia de comandos del service worker es diferente, el nuevo service worker tendrá la oportunidad de instalarse, activarse y, finalmente, tomar el control.

Para simular este flujo de actualización, vuelve al editor de código de tu proyecto y realiza cualquier cambio en el código. Un cambio rápido sería reemplazar

self.addEventListener('install', (event) => {
  console.log('Inside the install handler:', event);
});

con

self.addEventListener('install', (event) => {
  console.log('Inside the UPDATED install handler:', event);
});

Después de realizar ese cambio, vuelve a la versión publicada de tu app de ejemplo y vuelve a cargar la página con la pestaña Application de DevTools aún abierta. Deberías ver algo similar a lo siguiente:

Muestra dos versiones del service worker instaladas.

Esto muestra que hay dos versiones de tu trabajador de servicio instaladas en este punto. La versión anterior, que ya estaba activada, se está ejecutando y controla la página actual. La versión actualizada del trabajador de servicio aparece a continuación. Está en el estado waiting y permanecerá en espera hasta que se cierren todas las pestañas abiertas que controla el service worker anterior.

Este comportamiento predeterminado garantiza que, si tu nuevo trabajador de servicio tiene una diferencia fundamental en el comportamiento con el anterior (como un controlador fetch que responde con recursos incompatibles con versiones anteriores de tu app web), no entrará en vigencia hasta que un usuario cierre todas las instancias anteriores de tu app web.

En resumen

Ahora deberías estar familiarizado con el proceso de registrar un service worker y observar su comportamiento con las herramientas de Chrome DevTools.

Ahora estás en una buena posición para comenzar a implementar estrategias de almacenamiento en caché y todo lo que ayudará a que tu app web se cargue de forma confiable y rápida.