Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Element.innerHTML y límites de seguridad al insertar texto

Distingue entre interpretar marcado e insertar texto literal. Aprende a prevenir XSS en el DOM y a entender qué cambia cuando se exige Trusted Types.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.

Al leer Element.innerHTML obtienes el contenido serializado del elemento, sin su etiqueta exterior. En un documento HTML, al asignarle un valor se analiza un fragmento en el contexto del elemento y normalmente se reemplazan sus nodos hijos. En un elemento HTML <template>, la lectura serializa el contenido de template.content y la asignación reemplaza los nodos hijos de ese DocumentFragment, no los del propio elemento. element.innerHTML += fragment también reemplaza nodos en lugar de añadirlos al final: lee el contenido serializado y vuelve a analizar la cadena concatenada.

En un elemento, leer Node.textContent devuelve el texto combinado de sus descendientes, no su marcado. Asignar una cadena no vacía reemplaza los hijos por un único nodo de texto; asignar una cadena vacía los elimina. Para conservar los hijos existentes, añade una cadena al final con append(text) o insértala en una posición elegida con respecto al elemento mediante insertAdjacentText(position, text). Ninguna de estas operaciones de texto interpreta el marcado ni las referencias de caracteres de la cadena.

No pases cadenas no confiables a innerHTML: es un punto de inyección de HTML que puede provocar XSS en el DOM. Los elementos script insertados así no se ejecutan, pero otros mecanismos, como los atributos de controladores de eventos, sí pueden ejecutar código. Muestra el texto no confiable en un elemento normal como div. Insertarlo como texto no hace que esos datos sean seguros en un contexto de script, de estilo o de URL, ni al volver a interpretarlos como HTML.

Si necesitas HTML con formato procedente de una fuente no confiable, usa setHTML() donde sea compatible o aplica un sanitizador de HTML probado antes de insertarlo. Nunca recurras a una asignación directa a innerHTML sin sanitizar. Si la CSP exige Trusted Types y no hay una política predeterminada, asignar una cadena común a innerHTML lanza TypeError. TrustedHTML no garantiza la sanitización: la seguridad depende de la política que lo creó. Son API de la plataforma web, no funcionalidades de ECMAScript; comprueba la compatibilidad de las protecciones que utilices.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
  const sample = "<em>A &amp; B</em>";
  const parsed = document.createElement("div");
  const literal = document.createElement("div");

  parsed.innerHTML = sample;
  literal.textContent = sample;

  console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
  console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>

Resultado

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; B</em>

Guarda el ejemplo como archivo HTML, ábrelo en un navegador sin exigencia de Trusted Types y consulta la consola del navegador. La cadena fija es inocua: el análisis crea un elemento `em` y convierte la referencia de carácter en `&`. La inserción como texto conserva toda la cadena y no crea ningún elemento hijo.

Lecciones relacionadas

  • JavaScript · Lección 15 · Avanzado · Versión: 4

Fuentes