Cómo trabajar con service workers

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

Familiarízate con el proyecto de muestra

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

  • Al principio, register-sw.js estará vacío, pero contendrá el código que se usó para registrar el service worker. 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 service worker 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 de tu 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 manera condicional, después de verificar si se admite navigator.serviceWorker.

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.

La ejecución de código adicional y la descarga de elementos pueden consumir recursos valiosos que, de otro modo, 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 haya terminado de renderizar la página actual. Una forma conveniente de aproximar esto es esperar hasta que se haya activado el evento window.load.

Uniendo esos dos puntos, agrega este código de registro de service worker 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 para aprender más tarde. 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 completa pantalla 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 algo como los siguientes mensajes de registro, que indican que el service worker se instaló y activó:

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 hay un cliente (pestaña abierta) controlado por el service worker.

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

Activa el flujo de actualización del service worker

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 service worker, recibirán 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 service worker, el navegador solicitará automáticamente el service-worker.js más reciente y verificará si hay cambios. Si alguna parte de la secuencia de comandos del service worker es diferente, el service worker nuevo podrá instalarse, activarse y, finalmente, tomar el control.

Puedes simular este flujo de actualización volviendo al editor de código de tu proyecto y haciendo 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 el cambio, regresa a la versión publicada de la app de ejemplo y vuelve a cargar la página con la pestaña de la aplicación de Herramientas para desarrolladores aún abierta. Deberías ver un resultado similar al siguiente:

Muestra dos versiones del service worker instaladas.

Esto muestra que hay dos versiones de tu service worker instaladas en este punto. La versión anterior, que ya estaba activada, se ejecuta y controla la página actual. La versión actualizada del service worker se muestra debajo. Se encuentra en el estado waiting y seguirá esperando hasta que se cierren todas las pestañas abiertas que controla el service worker anterior.

Este comportamiento predeterminado garantiza que, si el nuevo service worker tiene una diferencia fundamental en el comportamiento del anterior (como un controlador fetch que responde con recursos incompatibles con versiones anteriores de tu app web), no se active hasta que un usuario cierre todas las instancias anteriores de tu app web.

En resumen

Ahora deberías conocer bien el proceso de registro de un service worker y observar su comportamiento mediante las Herramientas para desarrolladores de Chrome.

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