Element: replaceWith()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Die Methode replaceWith() der Schnittstelle Element ersetzt dieses Element in der Liste der Kindknoten seines Elternknotens durch eine Reihe von Node-Objekten oder Zeichenfolgen. Zeichenfolgen werden als entsprechende Text-Knoten eingefügt. Wenn parentNode null ist, geschieht nichts.
Syntax
replaceWith(param1)
replaceWith(param1, param2)
replaceWith(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Reihe von
Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn der Knoten nicht an der angegebenen Stelle in der Hierarchie eingefügt werden kann.
Beispiele
replaceWith() verwenden
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 unscopable
Die Methode replaceWith() wird innerhalb einer with-Anweisung nicht in deren Gültigkeitsbereich aufgenommen. Weitere Informationen finden Sie unter Symbol.unscopables.
with (node) {
replaceWith("foo");
}
// ReferenceError: replaceWith is not defined
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-childnode-replacewith① |