The replaceWith() method of the CharacterData interface replaces this node in the children list of its parent with a set of Node objects or string.
Strings are inserted as Text nodes; the string is being passed as argument to the Text() constructor.
js
replaceWith(nodes)
nodes Optional
A comma-separated list of Node objects or strings that will replace the current node.
Note: If there no argument is passed, this method acts just remove the node from the DOM tree.
None (undefined).
HierarchyRequestError DOMException
Thrown when the node cannot be inserted at the specified point in the hierarchy.
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`
| Specification |
|---|
| DOM Standard # ref-for-dom-childnode-replacewith① |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
replaceWith |
54 | 17 | 49 | No | 39 | 10 | 54 | 54 | 49 | 41 | 10 | 6.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CharacterData/replaceWith