WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element: Kindknoten ersetzen und Attribute auf Vorhandensein prüfen

Mit `replaceChildren()` ersetzt oder entfernst du die Kindknoten eines Elements. Mit `hasAttribute()` prüfst du unabhängig vom Wert, ob das Element selbst ein Attribut hat.

Version: Current web platform; runtime support varies

Syntax

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

replaceChildren() und hasAttribute() sind Instanzmethoden von Element im DOM. Die erste ändert die Knoten direkt unter dem Element, die zweite prüft ein Attribut am Element selbst, ohne das DOM zu ändern. Beide gehören zur Webplattform, nicht zu ECMAScript 2024. Prüfe, ob die Zielumgebung ein DOM bereitstellt und beide Methoden unterstützt.

element.replaceChildren(...) ersetzt alle direkten Kindknoten, einschließlich Text- und Kommentarknoten. Die Methode akzeptiert beliebig viele Knoten und Zeichenketten. Ohne Argumente leert sie das Element, ohne es zu entfernen oder seine Attribute zu ändern. Zeichenketten werden zu Textknoten und anders als bei einer Zuweisung an innerHTML nicht als HTML geparst. Die Methode gibt undefined zurück.

Vorhandene Knoten werden verschoben, nicht geklont. Ein entfernter Knoten wird von seinem Elternknoten getrennt, bleibt aber nutzbar, wenn du eine Referenz darauf behältst. Würde das Einfügen einen Zyklus erzeugen, etwa wenn ein Element sein eigenes Kind werden soll, wird eine DOMException namens HierarchyRequestError ausgelöst.

element.hasAttribute(name) prüft ein Attribut anhand seines qualifizierten Namens und liefert auch bei einem leeren Wert oder der Zeichenkette "false" den Wert true. Ein Ergebnis von false bedeutet, dass das Attribut fehlt, und macht keine Aussage über seinen Wert. Lies den Wert mit getAttribute(name) aus; bei einem fehlenden Attribut liefert die Methode null. Für die Suche nach Namensraum und lokalem Namen nutze hasAttributeNS(namespace, localName). Bei einem booleschen HTML-Attribut wie disabled zählt das Vorhandensein: Der Wert "false" schaltet es nicht aus.

Beispiele

<!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>

Ergebnis

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

Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Ausgabe in der Konsole. Die Zeichenkette mit HTML-ähnlichem Inhalt bleibt Text, und `same node: true` bestätigt, dass `label` derselbe Knoten bleibt. Nach dem Leeren hat das Element weiterhin das Attribut `data-ready` mit leerem Wert.

Zugehörige Lektionen

  • JavaScript · Lektion 38 · Fortgeschritten · Version: 4

Quellen