MDN self-hosted library · e01.org

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

  • HierarchyRequestError DOMException
  • : 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()