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
js
replaceWith(nodes)
Parameters
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.
Return value
None (undefined
).
Exceptions
HierarchyRequestError
DOMException
-
Thrown when the node cannot be inserted at the specified point in the hierarchy.
Examples
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`
Specifications
Specification |
---|
DOM Standard # ref-for-dom-childnode-replacewith① |
Browser compatibility
BCD tables only load in the browser