WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.replaceWith — ein Element ersetzen

Element.replaceWith ersetzt ein Element innerhalb seines Elternelements durch Knoten und Text. Zeichenfolgen werden zu Text und nicht als HTML-Markup interpretiert.

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.replaceWith(...nodes)

Element.replaceWith stammt aus dem ChildNode-Mixin des DOM-Standards, nicht aus einer ECMAScript-Version. Der Aufruf element.replaceWith(...nodes) ersetzt das Element selbst, nicht seine Kinder; replaceChildren(...nodes) ändert die Kinder.

Die Argumente sind Knoten und Zeichenfolgen in der angegebenen Reihenfolge. Knoten werden verschoben, nicht kopiert; Zeichenfolgen erzeugen Text-Knoten, ohne HTML zu parsen. Die Methode gibt undefined zurück. Ein Aufruf ohne Argumente entfernt das Element; wenn es kein Elternelement hat, werden keine Änderungen vorgenommen.

Eine ungültige Baumstruktur kann HierarchyRequestError auslösen. Prüfe die Verfügbarkeit in einer DOM-Umgebung mit typeof Element.prototype.replaceWith === 'function'; die Node.js-Version allein belegt nicht, dass die Funktion unterstützt wird.

Beispiele

const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);

const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');

console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);

Ergebnis

new <text>
true
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