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 July 2015.

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

HierarchyRequestError DOMException

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 Standard
# ref-for-dom-childnode-replacewith①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch