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

CKTIS / JavaScript

Element: sustituir nodos hijos y comprobar la presencia de un atributo

Usa `replaceChildren()` para sustituir o quitar los nodos hijos de un elemento y `hasAttribute()` para comprobar si el propio elemento tiene un atributo, sea cual sea su valor.

Versión: Current web platform; runtime support varies

Sintaxis

element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);

replaceChildren() y hasAttribute() son métodos de instancia de Element en el DOM. El primero cambia los nodos que están directamente bajo un elemento; el segundo comprueba un atributo del propio elemento sin modificar el DOM. Son API de la plataforma web, no funciones de ECMAScript 2024. Comprueba que el entorno de ejecución de destino proporcione un DOM y admita ambos métodos.

element.replaceChildren(...) sustituye todos los nodos hijos directos, incluidos los de texto y comentario. Acepta cualquier cantidad de nodos y cadenas. Sin argumentos, vacía el elemento sin quitarlo ni cambiar sus atributos. Las cadenas se convierten en nodos de texto: a diferencia de una asignación a innerHTML, no se interpretan como HTML. El método devuelve undefined.

Los nodos existentes se mueven, no se clonan. Un nodo retirado queda separado de su padre, pero puedes seguir usándolo si conservas una referencia. Una inserción que crearía un ciclo, como hacer que un elemento sea su propio hijo, lanza una DOMException llamada HierarchyRequestError.

element.hasAttribute(name) busca un atributo por su nombre cualificado y devuelve true aunque su valor esté vacío o sea la cadena "false". Un resultado false indica que el atributo no existe, no que su valor sea falso. Para leer el valor, usa getAttribute(name), que devuelve null si falta el atributo. Para buscar por espacio de nombres y nombre local, usa hasAttributeNS(namespace, localName). En un atributo booleano de HTML como disabled, lo que importa es su presencia: asignarle el valor "false" no lo desactiva.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Replacing child nodes and checking attribute presence</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement("div");
  const label = document.createElement("strong");
  label.textContent = "Updated";
  panel.append("Old: ", label);

  console.log(`before: ${panel.hasAttribute("data-ready")}`);
  panel.setAttribute("data-ready", "");
  panel.replaceChildren("<b>literal</b> ", label);

  console.log(`text: ${panel.textContent}`);
  console.log(`same node: ${panel.lastChild === label}`);

  panel.replaceChildren();
  console.log(`child nodes: ${panel.childNodes.length}`);
  console.log(`after: ${panel.hasAttribute("data-ready")}`);
  console.log(`value: ${JSON.stringify(panel.getAttribute("data-ready"))}`);
})();
</script>
</body>
</html>

Resultado

before: false
text: <b>literal</b> Updated
same node: true
child nodes: 0
after: true
value: ""

Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y comprueba el resultado en la consola. La cadena que parece HTML sigue siendo texto, y `same node: true` confirma que `label` sigue siendo el mismo nodo. Tras vaciarse, el elemento conserva `data-ready` con un valor vacío.

Lecciones relacionadas

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

Fuentes