Registrar
// main.js
if ("serviceWorker" in navigator) {
const registro = await navigator.serviceWorker.register("/sw.js");
console.log("alcance:", registro.scope);
}
Un Service Worker controla las páginas dentro de su alcance: por defecto, la carpeta donde está el archivo y sus subcarpetas. Por eso suele vivir en la raíz del sitio. Solo funciona en HTTPS (o en localhost, para desarrollar).
El ciclo de vida
install: la primera vez que se registra (o cuando cambia el archivo). El momento de guardar en caché lo necesario para funcionar sin conexión.activate: cuando ya no queda ninguna página usando una versión anterior. El momento de borrar cachés viejas.fetch: cada petición de las páginas que controla pasa por aquí.
// sw.js
const VERSION = "v3";
const ESENCIALES = ["/", "/estilos.css", "/app.js", "/sin-conexion.html"];
self.addEventListener("install", (e) => {
e.waitUntil(caches.open(VERSION).then((cache) => cache.addAll(ESENCIALES)));
});
self.addEventListener("activate", (e) => {
e.waitUntil(
caches.keys().then((claves) =>
Promise.all(claves.filter((c) => c !== VERSION).map((c) => caches.delete(c)))
)
);
});
e.waitUntil(promesa) le dice al navegador que no dé por terminada la fase hasta que la promesa se cumpla.
Ojo: en la primera visita, la página ya estaba cargada antes de que existiera el Service Worker, así que no la controla. Empieza a controlar desde la siguiente navegación (o enseguida, si llama a self.clients.claim() al activarse).
Estrategias de caché
En el evento fetch, e.respondWith(promesa) responde la petición con lo que quieras:
self.addEventListener("fetch", (e) => {
const url = new URL(e.request.url);
// Archivos que cambian poco: primero la caché, si no, la red
if (url.pathname.match(/\.(css|js|woff2|png)$/)) {
e.respondWith(
caches.match(e.request).then((guardada) => guardada ?? fetch(e.request))
);
return;
}
// Páginas: primero la red, y si no hay conexión, la copia guardada o una página de aviso
if (e.request.mode === "navigate") {
e.respondWith(
fetch(e.request).catch(async () =>
(await caches.match(e.request)) ?? caches.match("/sin-conexion.html")
)
);
}
});
Las estrategias más comunes:
| Estrategia | Cómo | Para |
|---|---|---|
| Cache first | Caché; si no está, red | Archivos con versión en el nombre, fuentes, imágenes |
| Network first | Red; si falla, caché | Páginas y datos que deben estar al día |
| Stale-while-revalidate | Caché enseguida y, en paralelo, red para actualizar | Datos que pueden estar un poco viejos |
Escribir esto a mano es delicado; la librería Workbox, de Google, implementa estas estrategias y el precacheo.
Actualizar
Si cambias sw.js, el navegador detecta la versión nueva, la instala y la deja esperando hasta que se cierren todas las pestañas con la vieja. Para activarla antes, la versión nueva puede llamar a self.skipWaiting(), con cuidado: las páginas abiertas pasarían a usar un Service Worker que no esperaban.
PWA: instalar la web como aplicación
Una Progressive Web App es una web que, además, se puede instalar: tiene su ícono, se abre en su propia ventana y funciona sin conexión. Necesita:
- HTTPS.
- Un manifiesto con el nombre, los íconos, los colores y cómo se abre:
{
"name": "Domina JS",
"short_name": "DominaJS",
"start_url": "/",
"display": "standalone",
"background_color": "#1b2a23",
"theme_color": "#f7df1e",
"icons": [{ "src": "/icono-512.png", "sizes": "512x512", "type": "image/png" }]
}
<link rel="manifest" href="/manifest.webmanifest">
- Un Service Worker con un evento
fetch, para que funcione sin conexión.
Resumen
- Un Service Worker se pone entre tus páginas y la red; controla las páginas dentro de su alcance.
- Ciclo: registro →
install(precachear) →activate(limpiar) →fetch(responder). e.respondWithresponde con caché, red o una combinación: cache first, network first, stale-while-revalidate.- Las versiones nuevas esperan a que se cierren las páginas viejas, salvo
skipWaiting. - PWA = HTTPS + manifiesto + Service Worker.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Un intermediario entre la página y la red
Resuelto
Elige una respuesta en cada pregunta.
¿Qué es un Service Worker?
En la primera visita, ¿controla el Service Worker la página que lo registró?
¿Qué es la estrategia stale-while-revalidate?
¿Qué se necesita para que una web se pueda instalar como app (PWA)?
Ordena la salida: El ciclo de vida
Resuelto
Una primera visita y una recarga. Ordena los mensajes que aparecerían en la consola del Service Worker.
1// sw.js2self.addEventListener("install", () => console.log("install"));3self.addEventListener("activate", () => console.log("activate"));4self.addEventListener("fetch", (e) => console.log("fetch", new URL(e.request.url).pathname));5 6// main.js, en la página /index.html (que carga /app.js)7navigator.serviceWorker.register("/sw.js");8 9// Primera visita: se registra. Después, el usuario recarga la página.Consola, de arriba abajo
- fetch /index.html
- install
- fetch /app.js
- activate
En la primera visita, el Service Worker se instala y se activa, pero esa página ya estaba cargada y no la controla. Al recargar, ya controla la navegación: intercepta la petición del HTML y, después, la de cada recurso que el HTML pide.
Detective: Un Service Worker en una carpeta
Resuelto
El registro del Service Worker falla con un error de seguridad. Encuentra la línea y elige el arreglo.
Consola
Uncaught (in promise) SecurityError: Failed to register a ServiceWorker for scope ('https://mi-sitio.com/') with script ('https://mi-sitio.com/js/sw.js'): The path of the provided scope ('/') is not under the max scope allowed ('/js/'). Adjust the scope, move the Service Worker script, or use the Service-Worker-Allowed HTTP header to allow the scope.Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?