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①> |