Trusted Types
Por qué importa La CSP bloquea las etiquetas de script inyectadas. Pero muchos fallos modernos viven dentro de tu propio JavaScript: una línea como box.innerHTML = comment convierte el texto de un visitante en HTML vivo. Esa es la inyección basada en el DOM del módulo 10 (lección 59), y ocurre después de que la página se haya cargado. Trusted Types hace que el navegador rechace esas líneas peligrosas a menos que el valor haya pasado por una comprobación que escribiste tú.
Imagina una fábrica en la que solo las piezas con un sello de inspección pueden ir a la cadena de montaje. Nadie puede atornillar una pieza cualquiera encontrada en el aparcamiento, ni siquiera sin querer. Trusted Types añade ese sello a las cadenas que tu código mete en lugares peligrosos.
DOM: abreviatura de Document Object Model, el árbol vivo de elementos que el navegador construye a partir de una página, y que JavaScript puede leer y cambiar.
Sumidero (sink): un lugar del DOM donde una cadena se convierte en código o en marcado. Ejemplos: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval y los argumentos de texto de setTimeout, y script.src.
Trusted Types: una función del navegador, activada por la CSP, con la que esos sumideros solo aceptan objetos especiales (TrustedHTML, TrustedScript, TrustedScriptURL) creados por una política, una pequeña función que escribes tú y a la que pones nombre. Una cadena normal asignada a un sumidero lanza un error en lugar de ejecutarse.
Activarlo
Content-Security-Policy: require-trusted-types-for 'script'; trusted-types commentsrequire-trusted-types-for 'script': lo aplica a todos los sumideros relacionados con scripts.trusted-types comments: el único nombre de política que puede crear tu código. Un script inyectado no puede registrar una política propia con otro nombre.trusted-types 'none'prohíbe crear ninguna.
Usarlo en tu código
// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
createHTML: (text) => escapeHtml(text), // or a well-tested sanitiser
});
box.innerHTML = comment; // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment); // allowed, escaped
box.textContent = comment; // not a sink at all: always fineLa gran ventaja es para quienes revisan el código. En lugar de buscar cada innerHTML en un código grande, revisas las pocas funciones de política. Si son seguras, el navegador se encarga de que todo lo demás pase por ellas.
Una política llamada default es especial: el navegador la llama automáticamente cada vez que una cadena normal llega a un sumidero. Es útil mientras migras código antiguo, pero también es un sitio donde se esconden los errores, así que mantenla estricta y registra lo que pasa por ella.
Compatibilidad y despliegue
Trusted Types está disponible en todos los motores principales: los navegadores basados en Chromium, Safari 26 y Firefox 148 (comprobado en octubre de 2026). Los visitantes con navegadores más antiguos simplemente no reciben la comprobación extra, así que sigue escapando y mantén tu CSP basada en nonces. El código puede comprobarlo con if (window.trustedTypes).
Despliégalo como cualquier política: envía primero require-trusted-types-for 'script' en una cabecera Content-Security-Policy-Report-Only. Se informa de cada cadena que llega a un sumidero, lo que te muestra exactamente qué líneas necesitan una política o, mejor, un cambio a textContent.
Una idea equivocada muy común: "Trusted Types sanea el HTML por mí". No limpia nada. Obliga a que las cadenas pasen por tu política. Una política que devuelve su entrada sin cambios (createHTML: s => s) pasa la comprobación y no protege nada.
Resumen
- La inyección en el DOM ocurre en tu propio JavaScript, en sumideros como
innerHTML; las reglas sobre etiquetas de script no la atrapan por sí solas. require-trusted-types-for 'script'hace que los sumideros rechacen las cadenas normales;trusted-types NAMElimita qué políticas pueden existir.- Revisa las pocas funciones de política en lugar de cada sumidero, y prefiere
textContentdonde puedas. - Disponible en todos los motores principales (comprobado en octubre de 2026); despliégalo primero en report-only.
¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección
Este ejercicio se abre pronto
Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.
Este navegador está bloqueando las cookies de learn.floati.life, así que las lecciones que terminaste aquí no se pueden abrir en orden. Permite las cookies de este sitio y recarga.