Skip to content

fix(sw): network-first y no cachear errores - #32

Merged
PabloCastroCastro merged 1 commit into
developfrom
feature/GH-5
Nov 4, 2026
Merged

PabloCastroCastro merged 1 commit into
developfrom
feature/GH-5

Conversation

@PabloCastroCastro

Copy link
Copy Markdown
Owner

Qué cambia y por qué

El service worker tenía cuatro problemas:

  1. Servía primero la caché. Los cambios en /data (y en el código) se veían con una carga de retraso, y un app.js nuevo podía juntarse con un shared.js viejo. El cache: "no-store" de fetchJSON no servía de nada.
  2. Cacheaba cualquier respuesta, incluidos 404/500, que después se servían como buenas. Esto afecta al "Reintentar" de Ronda 2 se queda en "Cargando…" si falla la carga del tipo de cena #19.
  3. Silenciaba los fallos del precache (addAll(...).catch(() => {})), que además es todo o nada.
  4. Sin red, la app no arrancaba, aunque fuera una PWA.

Nueva estrategia (service-worker.js)

  • Mismo origen (HTML, JS, CSS, iconos, /data): network-first. Con conexión siempre llega lo último publicado. La caché se usa solo si no hay red o si la red tarda más de 4 s. Tras un timeout, durante 15 s se sirve directamente de caché, sin dejar de actualizarla en segundo plano, para que la cadena HTML → JS → JSON no sume un timeout por nivel.
  • Error del servidor con copia en caché → se sirve la copia. Sin copia → el error llega a la app, que lo muestra (Ronda 2 se queda en "Cargando…" si falla la carga del tipo de cena #19).
  • Otros orígenes (Google Fonts): cache-first.
  • Solo se guardan respuestas ok (u opacas, solo de otros orígenes).
  • Precache fichero a fichero, con console.warn del que falle; el resto sí se guarda.
  • CACHE_NAME → dinner-match-v4, para purgar cachés antiguas con 404 guardados.

Versionado (criterio de la issue): con network-first ya no hace falta subir CACHE_NAME para publicar cambios. CONTRIBUTING.md explica cuándo sí: al renombrar o borrar ficheros del shell, o al cambiar la estrategia. Lo prefiero a un hash automático, que exigiría un build step.

tests/sw.test.mjs (en CI) comprueba que:

  • todas las rutas de ASSETS existen;
  • todo js/*.js, el CSS, los HTML, el manifest y sus iconos están precacheados (si no, la app no arranca offline en la primera visita).

Docs: README ("Publicar cambios de contenido o de código"), CONTRIBUTING ("Service worker y caché") y CHANGELOG.

Rama base

develop

Issue relacionada

Closes #5

Pruebas

  • node --test: 51/51.
  • E2E en Chrome headless con el SW activo (servido en localhost), contra un servidor que simula fallos:
Caso Este PR SW de develop
SW instalado y con el shell precacheado ✅ ✅
Cambio en dish-types.json visible en la primera recarga ✅ ❌ (contenido viejo)
404 en data/types/* no se cachea; con el servidor arreglado, Reintentar entra a la primera ✅ ✅*
La respuesta buena del tipo sí se cachea ✅ ❌
500 puntual con copia en caché → arranca con la copia ✅ ✅
Sin red → la app arranca desde caché ✅ ❌ ("No se pudo cargar")
Red colgada → arranca desde caché ✅ 4,1 s ❌ 12 s
Primera visita sin caché + 500 → el error llega a la app ✅ ✅
Sin excepciones JS ✅ ✅

* En el E2E, con el SW viejo el 404 no llegó a quedarse en caché a tiempo para afectar al reintento, pero el código lo guardaba igualmente (cache.put sin comprobar ok).

Checklist

  • Probado en local (con service worker activo)
  • node --test pasa (y la CI está en verde)
  • No toqué js/shared.js
  • Documentación actualizada

🤖 Generated with Claude Code

El service worker servía primero la caché (los cambios de /data y del
código llegaban con una carga de retraso, y JS nuevo podía mezclarse con
JS viejo), guardaba cualquier respuesta incluidos 404/500, y silenciaba
los fallos del precache. Además, sin red la app no llegaba a arrancar.

- Mismo origen: network-first con timeout de 4 s; tras un timeout, 15 s
  sirviendo de caché directamente para no sumar un timeout por nivel
  (HTML → JS → JSON). Un error del servidor con copia en caché sirve la
  copia; sin copia, el error llega a la app.
- Otros orígenes (Google Fonts): cache-first.
- Solo se cachean respuestas ok (u opacas de otros orígenes).
- Precache fichero a fichero con console.warn del que falle.
- CACHE_NAME → v4 para purgar las cachés con 404 guardados.

tests/sw.test.mjs comprueba que ASSETS existe, cubre todo js/, el CSS,
los HTML, el manifest y sus iconos. Documentado en README (publicar
cambios) y CONTRIBUTING (cuándo subir CACHE_NAME).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PabloCastroCastro
PabloCastroCastro merged commit a988e3e into develop Nov 4, 2026
1 check passed
@PabloCastroCastro
PabloCastroCastro deleted the feature/GH-5 branch November 4, 2026 15:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant