English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

JS DOM reference manual

HTML DOM Element Object

replaceChild()HTML DOM replaceChild() method

The method replaces a child node with a new node in the given parent node.

The new node can be an existing node in the document or a newly created node.useThe method removes a child node from the parent node.

Syntax:

node.replaceChild(newNode, oldNode)
var newElem = document.querySelector("p");
var div = document.getElementById("demo");
div.replaceChild(newElem, div.firstElementChild);
Test See </›

Browser compatibility

All browsers fully support the replaceChild() method:

Method
replaceChild()IsIsIsIsIs

Parameter value

ParameterDescription
newNodeThe node object you want to insert
oldNodeThe node object you want to delete

Technical details

Return value:A Node object representing the node to be replaced
DOM Version:DOM Level1

More Examples

Create a new node and replace it with an existing node:

var newElem = document.createElement("h"2");
var newContent = document.createTextNode("Hi there and greetings!");
newElem.appendChild(newContent);
var div = document.getElementById("demo");
div.replaceChild(newElem, div.firstElementChild);
Test See </›

Related References

HTML DOM Reference:node .parentNode() method

HTML DOM Reference:node .hasChildNodes() method

HTML DOM Reference:node .appendChild() method

HTML DOM Reference:node .insertBefore() method

HTML DOM Reference:node .removeChild() method

HTML DOM Element Object