CharacterData: replaceWith() method
DOM
DOM
The replaceWith() method of the CharacterData interface replaces this CharacterData in the children list of its parent with a set of Node objects or strings. Strings are inserted as equivalent Text nodes. Nothing happens if parentNode is null.
Syntax
replaceWith(param1)
replaceWith(param1, param2)
replaceWith(param1, param2, /* …, */ paramN)
Parameters
param1, …,paramN- : A set of Node objects or strings to insert.
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>
const text = document.getElementById("myText").firstChild;
const em = document.createElement("em");
em.textContent = "Italic text";
text.replaceWith(em); // Replace `Some text` by `Italic text`
100%
Specifications
Browser compatibility
See also
- CharacterData.replaceData()
- DocumentType.replaceWith()
- Element.replaceWith()