CKTIS / JavaScript
HTMLElement.innerHTML: leer y sustituir el contenido de un elemento
Al leer `innerHTML` se obtiene el marcado del contenido de un elemento. Al asignarle un valor se crean nodos que sustituyen ese contenido, incluso con `+=`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML es una propiedad de instancia heredada de Element, no un método estático. Al leerla, se obtiene una cadena con el contenido actual del DOM, sin las etiquetas del propio elemento ni las raíces del Shadow DOM. Es una serialización del árbol, no una copia del texto fuente.
La asignación analiza el marcado en el contexto del elemento y sustituye sus nodos hijos, no el propio elemento. En template, sustituye el contenido de template.content. El método de asignación acepta una cadena o TrustedHTML. Web IDL convierte null en la cadena vacía ("") antes de la comprobación de Trusted Types. Si la cadena llega sin cambios al analizador, se vacía el contenido. Sin embargo, si se exige Trusted Types, una política predeterminada puede convertir la cadena vacía en marcado no vacío, por lo que una asignación correcta no siempre vacía el contenido. No se crean raíces declarativas del Shadow DOM.
element.innerHTML += markup lee el marcado serializado, concatena el texto nuevo y vuelve a analizar todo el resultado. Los nodos antiguos se separan del árbol y los escuchadores de eventos registrados directamente en ellos no pasan a los nodos nuevos. Para conservar los nodos existentes, añade los nuevos con append().
No pases datos no fiables directamente a innerHTML: no los sanea de forma predeterminada y los atributos de gestión de eventos pueden provocar XSS aunque los elementos script insertados no se ejecuten. Usa textContent para texto sin formato y un sanitizador de eficacia comprobada si necesitas HTML. Una política de Trusted Types no garantiza por sí sola el saneamiento.
Esta API pertenece a la plataforma web, no a ECMAScript 2024. La compatibilidad con Trusted Types varía según el entorno. Si la CSP exige Trusted Types y no hay una política predeterminada, asignar una cadena lanza TypeError. El análisis de HTML se recupera de errores de sintaxis, pero en un documento XML un fragmento mal formado puede lanzar SyntaxError al asignarlo, y un contenido que no se puede serializar como XML bien formado puede lanzar InvalidStateError al leerlo.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Resultado
<strong>Hello</strong><em> again</em> Hello again false true
Guarda el ejemplo como archivo HTML, ábrelo en un navegador sin exigir Trusted Types y consulta la consola de desarrollo. Las dos primeras líneas comparan el marcado con el texto; las dos últimas muestran que el primer nodo fue sustituido y ya no tiene padre.
Lecciones relacionadas
- JavaScript · Lección 31 · Avanzado · Versión: 4