W3cubDocs

/Web APIs

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

Browser compatibility

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

See also

© 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