WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Node.replaceChild — ein Kind ersetzen

Node.replaceChild ersetzt ein direktes Kind eines übergeordneten Knotens und gibt den entfernten Knoten zurück. Der neue Knoten wird als erstes Argument übergeben.

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

const removedNode = parent.replaceChild(newChild, oldChild);

parent.replaceChild(newChild, oldChild) ersetzt oldChild durch newChild und gibt oldChild zurück. Die Argumente müssen Knoten sein, keine Zeichenfolgen. Dies ist eine DOM-API und kein ECMAScript-Feature.

Ein bereits vorhandener newChild wird verschoben, nicht kopiert. Ein DocumentFragment fügt seine Kinder ein, nicht das Fragment selbst.

Eine ungültige Struktur, etwa ein Zyklus, kann HierarchyRequestError auslösen. Die Methode prüft, ob durch die Ersetzung ein Zyklus entstehen würde, bevor sie prüft, ob oldChild ein direktes Kind von parent ist. Wenn die vorherigen Prüfungen keinen Fehler ergeben und oldChild kein direktes Kind von parent ist, löst die Methode NotFoundError aus.

Beispiele

const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);

const removedNode = parent.replaceChild(newChild, oldChild);

console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);

Ergebnis

new
true
true

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.

Quellen