CharacterData: replaceWith()-Methode

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 replaceWith()-Methode des CharacterData-Interfaces ersetzt diesen Knoten in der Kinderliste seines Elternteils mit einer Gruppe von Node-Objekten oder Zeichenfolgen.

Zeichenfolgen werden als Text-Knoten eingefügt; die Zeichenfolge wird als Argument an den Text()-Konstruktor übergeben.

Syntax

js
replaceWith(...nodes)

Parameter

nodes Optional

Eine durch Kommas getrennte Liste von Node-Objekten oder Zeichenfolgen, die den aktuellen Knoten ersetzen werden.

Hinweis: Wenn keine Argumente übergeben werden, entfernt diese Methode den Knoten aus dem DOM-Baum.

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

html
<p id="myText">Some text</p>
js
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";

text.replaceWith(em); // Replace `Some text` by `Italic text`

Spezifikationen

Specification
DOM Standard
# ref-for-dom-childnode-replacewith①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch