---
title: Node.replaceChild
slug: Web/API/Node/replaceChild
translation_of: Web/API/Node/replaceChild
---
<p>{{ ApiRef() }}</p>

<h3 id="Summary" name="Summary">Zusammenfassung</h3>

<p><strong>Die <code>Node.replaceChild()</code></strong>-Methode ersetzt den Kind-Knoten (<code>child node)</code> <u>innerhalb</u> des gegebenen Eltern-Knotens (<code>parent node</code>) durch einen anderen.</p>

<h3 id="Syntax" name="Syntax">Syntax</h3>

<pre class="eval"><em>replacedNode</em> = <em>parentNode</em>.replaceChild(<em>newChild</em>, <em>oldChild</em>);
</pre>

<ul>
 <li><code>newChild</code> ist der neue, <code>oldChild</code> der zu ersetzende Knoten. Falls er bereits im DOM vorhanden ist, wird er zuerst von dort entfernt.</li>
 <li><code>oldChild</code> ist der zu ersetzende Knoten.</li>
 <li><code>replacedNode</code> ist der ersetzte Knoten, also der selbe wie <code>oldChild</code>.</li>
</ul>

<h3 id="Example" name="Example">Beispiel</h3>

<pre>// &lt;div&gt;
//  &lt;span id="childSpan"&gt;foo bar&lt;/span&gt;
// &lt;/div&gt;

// erzeuge einen leeren Element-Knoten
// ohne ID, Attribute oder Inhalt
var sp1 = document.createElement("span");

// setze sein id Attribut auf 'newSpan'
sp1.setAttribute("id", "newSpan");

// Inhalt für das neue Element erzeugen
var sp1_content = document.createTextNode("new replacement span element.");

// den erzeugten Inhalt an das Element anhängen
sp1.appendChild(sp1_content);

// Referenz auf den zu ersetzenden Knoten erzeugen
var sp2 = document.getElementById("childSpan");
var parentDiv = sp2.parentNode;

// den existierenden Knoten sp2 mit dem neuen Span-Element sp1 ersetzen
parentDiv.replaceChild(sp1, sp2);

// Ergebnis:
// &lt;div&gt;
//   &lt;span id="newSpan"&gt;new replacement span element.&lt;/span&gt;
// &lt;/div&gt;
</pre>

<h3 id="Specification" name="Specification">Spezifikation</h3>

<p><a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-replaceChild">DOM Level 1 Core: replaceChild</a></p>

<p><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-785887307">DOM Level 2 Core: replaceChild</a></p>

<p>{{ languages( { "fr": "fr/DOM/element.replaceChild", "ja": "ja/DOM/element.replaceChild", "pl": "pl/DOM/element.replaceChild", "zh-cn": "zh-cn/DOM/Node.replaceChild" } ) }}</p>