[jamataran]

Segundo paso de #110: si un navegador no puede con el visor, el alumno ve qué hacer en vez de una pantalla en blanco, y el servidor lo deja escrito en el log. Apilado sobre #111: se mergea después de que #111 esté en test (al borrar su rama, GitHub cambia la base de éste a test; si no, cámbiala a mano).

Qué cambia

• Suelo del visor: navegadores de 2020 (Chrome 80, Firefox 74, Safari/iOS 13.4). pdf.js y collection.js dejan el await de nivel superior (Safari 14 y Chrome < 89 no lo entienden y no ejecutaban ni una línea). test/ui-compat.test.js recorre los import desde cada entrada y comprueba con el Linter de ESLint que nada pase de ES2021, ni use asignación lógica (Safari 14) ni lookbehind (Safari 16.4). eslint.config.js repite el suelo para que lo marque el editor.
• Guardia de arranque assets/compat.js, ES5 y script clásico, antes que hls.min.js y que el módulo:
  • pone replaceChildren si falta (el visor lo usa al arrancar);
  • anota el primer fallo de un script;
  • en load, si el visor no dejó window.__visorArrancado, pinta en #content qué hacer (volver a abrir, otro navegador, Windows 7, iOS, la app de Moodle), ofrece la copia sellada de cada PDF por XHR y lo cuenta al servidor.
  • Un <noscript> cubre el caso sin JavaScript.
• POST /telemetry/compat: exige sesión y deja una línea warn «Visor sin arrancar en este navegador» con user-agent, página y motivo (sin-modulos, sintaxis, carga, ejecucion, sin-arranque, pdfjs, sin-hls o medio; enumerado y recortado). Responde 204 siempre y no guarda nada propio ni el sub. Lo usan la guardia, el visor de PDF cuando PDF.js no carga y el vídeo cuando el navegador no puede reproducirlo; esos mensajes dicen ahora qué hacer.
• <dialog> sin soporte nativo (Safari < 15.4, Firefox < 98): el aviso legal se abre como capa y su form method="dialog" se intercepta. Antes, pulsar «Entendido» mandaba un GET a /lti/launch.
• Docs: ADR-036, «En qué navegadores arranca el visor» y el endpoint en docs/arquitectura.md, fila «Navegadores» en las limitaciones de docs/README.md y trampas en CLAUDE.md y docs/desarrollo.md.

Regla 0-bis

Nada de lo desplegado se rehace. En un navegador que arranca el visor no cambia nada visible: la guardia sólo lee una marca.

Evidencia

Pruebas: npm run lint limpio · npm test 515 pruebas, 0 fallos (10 saltadas: las de la imagen del worker).

• test/ui-compat.test.js (9): suelo de sintaxis por el grafo real; la misma lista en eslint; la guardia en ES5 y en su sitio de cada HTML; la marca de cada entrada; y la guardia ejecutada en un DOM mínimo. Con el visor sano no toca nada; con un SyntaxError explica, ofrece la copia y lo cuenta; reconoce un navegador sin módulos; no confunde el error de un <video> con el de un script.
• test/telemetry-compat.test.js (3) y test/dialogo-sin-soporte.test.js (3).

Motores reales (Chromium 109, Firefox 115 ESR, Chrome 154), con la CSP de producción y en un iframe de otro origen:

Escenario	Chromium 109	Firefox 115	Chrome 154
Uso normal (5 PDF, 2 colecciones, vídeo): marca puesta, sin aviso	✅	✅	✅
Entrada rota a propósito (collection.js)	aviso + informe coleccion/sintaxis	ídem	ídem
Dependencia rota (pdf-component.js)	aviso + informe pdf/sintaxis	ídem	ídem
Vídeo que el navegador no puede descodificar	informe video/medio (bufferAddCodecError)*	se reproduce	se reproduce

* El Chromium de los snapshots no trae H.264: es justo el caso que el informe tiene que registrar.

Por análisis, no probado aquí: Safari 13.4–16.3 y los Chromium < 109 de los televisores. Para eso está la línea del log.

Tras la revisión (8 oct)

Ningún falso positivo ni regresión para quien ya entraba. Se arreglan cinco cabos menores, cada uno con una prueba que falla con el código anterior. Incluye #111 actualizado (merge).

• Guardia: un reintento de descarga que sale bien devuelve el rótulo del botón, no el error del intento anterior.
• Diálogo de respaldo (Safari < 15.4, Firefox < 98): el foco entra al abrirlo y vuelve al cerrarlo.
• Suelo de sintaxis: ahora cubre de verdad Firefox 74 y Safari 13.4.
  • Añade grupos con nombre, \p{…}, flag s, BigInt y export * as.
  • Una prueba comprueba que caza cada caso.
  • El grafo se lee del árbol sintáctico, así que sigue también los export … from.
  • Hoy ningún módulo del visor usaba nada de eso.
• Log: «Visor sin arrancar en este navegador» queda para quien se queda fuera por el navegador. Cuando el visor arrancó y falló PDF.js o el vídeo, la línea es «Visor sin poder con el PDF o el vídeo en este navegador», porque eso también pasa en un navegador al día.
• Funciones del navegador (no sólo sintaxis) que usa el visor: todas están dentro del suelo. Picture-in-Picture y la pantalla completa se comprueban antes de usarlas.

Para cerrar #110

En test, con Moodle y los aparatos de #110; y en prod, una semana de docker logs <app> 2>&1 | grep -E 'Visor sin (arrancar|poder)'.

Refs #110

🤖 Generated with Claude Code

https://claude.ai/code/session_01WqzjFTX6sP8s6J24cx7aYv