CKTIS / JavaScript
Element.replaceChildren() — alle untergeordneten Knoten ersetzen
Element.replaceChildren() ersetzt die untergeordneten Knoten eines Elements durch die als Argumente angegebenen Knoten und Zeichenfolgen. Ohne Argumente werden alle untergeordneten Knoten entfernt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.replaceChildren(...nodes)Element.replaceChildren stammt aus dem ParentNode-Mixin des DOM-Standards, nicht aus ECMAScript. Die Methode ersetzt alle untergeordneten Knoten eines Elements, während das Element selbst erhalten bleibt. Sie gibt undefined zurück.
Als Argumente dienen Knoten oder Zeichenfolgen, die in der angegebenen Reihenfolge verarbeitet werden. Zeichenfolgen werden zu Text-Knoten und nicht als HTML geparst. Vorhandene Knoten werden verschoben, nicht geklont. Wird derselbe Knoten erneut angegeben, wird er verschoben, statt einen weiteren untergeordneten Knoten hinzuzufügen. Sind a und b unterschiedliche Elemente, bleiben nach element.replaceChildren(a, b, a) die Knoten b und a in dieser Reihenfolge übrig. element.replaceChildren() entfernt alle untergeordneten Knoten.
Eine ungültige Hierarchie, zum Beispiel das Einfügen eines Elements in sich selbst, löst eine DOMException mit dem Namen HierarchyRequestError aus.
Dies ist eine Browser-DOM-API; die Verfügbarkeit von Node 24 belegt nicht, dass sie verfügbar ist. Prüfe in der Zielumgebung typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.
Beispiele
const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';
box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);
box.replaceChildren();
console.log(box.childNodes.length);Ergebnis
Status: New 2 true 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.