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.