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

CKTIS / JavaScript

Seleccionar un descendiente con querySelector() y cambiar su contenido con innerHTML

Encuentra el primer descendiente que coincide con un selector CSS, gestiona la ausencia de coincidencias y lee o reemplaza el marcado del elemento seleccionado.

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

Sintaxis

const target = root.querySelector(selectors);
if (target !== null) {
  const previousMarkup = target.innerHTML;
  target.innerHTML = markup;
}

Element.querySelector/innerHTML combina dos operaciones: encontrar un elemento y trabajar con su contenido. root.querySelector(selectors) acepta una cadena con un selector CSS o una lista de selectores separados por comas. Devuelve el primer elemento descendiente que coincide en el orden del árbol DOM, con independencia del orden de los selectores en la lista. Nunca devuelve root. Si no hay coincidencias, devuelve null; una sintaxis de selector no válida lanza una DOMException llamada SyntaxError. Comprueba el resultado antes de leer o asignar una propiedad.

El resultado debe ser descendiente de root, pero para comprobar la coincidencia se pueden tener en cuenta ancestros que estén fuera de ese subárbol. Usa :scope > .message para limitar las coincidencias a los hijos directos de root con la clase message. No es una búsqueda en todo el documento como la de document.querySelector().

Al leer target.innerHTML obtienes el contenido serializado como cadena, sin las etiquetas del propio elemento ni las raíces del Shadow DOM. Una asignación analiza un fragmento en el contexto del elemento y reemplaza sus hijos, no el elemento en sí. En un elemento template, reemplaza el contenido de la plantilla. Las referencias guardadas y los escuchadores de eventos siguen asociados a los nodos antiguos que se han separado del árbol, no a los nuevos. En un documento XML, asignar un fragmento mal formado lanza SyntaxError; la lectura puede lanzar InvalidStateError si falla la serialización XML. Ambas son DOMException.

No asignes datos no fiables directamente a innerHTML: no sanea el marcado de forma predeterminada y puede dar lugar a XSS. Para texto sin formato, usa textContent. Si necesitas marcado de una fuente no fiable, sanéalo primero. Trusted Types no realiza ese saneamiento por sí solo. Si el entorno admite Trusted Types y una CSP los exige, asignar una cadena normal sin una política predeterminada adecuada lanza TypeError. En su lugar, pasa un objeto TrustedHTML generado por una política que sanee la entrada.

Son API de la plataforma web, no de ECMAScript 2024. Comprueba que el entorno de ejecución proporcione un DOM y admita las funciones de seguridad que necesites.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>querySelector() and innerHTML</title>
</head>
<body>
  <script>
    {
      const panel = document.createElement("div");
      panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';

      const target = panel.querySelector(".message");
      if (target !== null) {
        const oldChild = target.firstElementChild;
        console.log(target.innerHTML);
        target.innerHTML = "<strong>After</strong>";
        console.log(target.innerHTML);
        console.log(oldChild.parentNode === null);
        console.log(target.nextElementSibling.textContent);
      }
      console.log(panel.querySelector(".missing") === null);
    }
  </script>
</body>
</html>

Resultado

<em>Before</em>
<strong>After</strong>
true
Unchanged
true

Guarda el ejemplo como archivo `.html` y ábrelo en un navegador sin una CSP que exija Trusted Types. Consulta la salida en la consola del navegador. Solo cambia la primera coincidencia. Su antiguo hijo ya no tiene padre, el segundo elemento conserva el texto `Unchanged` y la búsqueda sin coincidencias devuelve `null`.

Lecciones relacionadas

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

Fuentes