MDN Web Docs

Syntax

js

replaceWith(...nodes)

Parameters

nodes Optional

A comma-separated list of Node objects or strings that will replace the current node.

Note: If no arguments are passed in, this method removes 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
# ref-for-dom-childnode-replacewithâ‘ 

Browser compatibility

See also

Help improve MDN

Yes No

Learn how to contribute

This page was last modified on by MDN contributors.

Read the original on developer.mozilla.org ↗