web api instance method
CharacterData: replaceWith() method
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.
Syntax
replaceWith(...nodes)
Parameters
nodesOptional- : A comma-separated list of
Nodeobjects or strings that will replace the current node.
- : A comma-separated list of
[!NOTE] If no arguments are passed in, this method removes the node from the DOM tree.
Return value
None (undefined).
Exceptions
HierarchyRequestErrorDOMException- : Thrown when the node cannot be inserted at the specified point in the hierarchy.
Examples
<p id="myText">Some text</p>
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";
text.replaceWith(em); // Replace `Some text` by `Italic text`
Interactive exampleOpen the canonical MDN source to run this embedded demo.
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.