Element: Methode replaceWith()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Die Element.replaceWith()-Methode ersetzt dieses Element in der Kindliste seines übergeordneten Elements durch eine Reihe von Node-Objekten oder Zeichenfolgen. Zeichenfolgen werden als äquivalente Text-Knoten eingefügt.
Syntax
js
replaceWith(param1) replaceWith(param1, param2) replaceWith(param1, param2, /* …, */ paramN) Parameter
param1, …,paramN-
Eine Reihe von
Node-Objekten oder Zeichenfolgen, die ersetzt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.
Beispiele
Verwendung von replaceWith()
js
const div = document.createElement("div"); const p = document.createElement("p"); div.appendChild(p); const span = document.createElement("span"); p.replaceWith(span); console.log(div.outerHTML); // "<div><span></span></div>" replaceWith() ist unscopeable
Die replaceWith()-Methode ist nicht im with-Statement eingeschlossen. Siehe Symbol.unscopables für weitere Informationen.
js
with (node) { replaceWith("foo"); } // ReferenceError: replaceWith is not defined Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-childnode-replacewith① |