This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The ChildNode.replaceWith() method replaces this ChildNode in the children list of its parent with a set of Node or DOMString objects. DOMString objects are inserted as equivalent Text nodes.
Syntax
[Throws, Unscopable] void ChildNode.replaceWith((Node or DOMString)... nodes);
Parameters
Exceptions
HierarchyRequestError: Node cannot be inserted at the specified point in the hierarchy.
Examples
Using replaceWith()
var parent = document.createElement("div");
var child = document.createElement("p");
parent.appendChild(child);
var span = document.createElement("span");
child.replaceWith(span);
console.log(parent.outerHTML);
// "<div><span></span></div>"
ChildNode.replaceWith() is unscopable
The replaceWith() method is not scoped into the with statement. See Symbol.unscopables for more information.
with(node) {
replaceWith("foo");
}
// ReferenceError: replaceWith is not defined
Specification
| Specification | Status | Comment |
|---|---|---|
| DOM The definition of 'ChildNode.replacewith()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 54.0 | 49 (49) | ? | 39 | ? |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | No support | 54.0 | 49.0 (49) | ? | 39 | ? | 54.0 |