CKTIS / JavaScript
Node.replaceChild — zastępowanie dziecka
Node.replaceChild zastępuje bezpośrednie dziecko rodzica i zwraca usunięty węzeł. Nowy węzeł podaje się jako pierwszy argument.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) zastępuje oldChild przez newChild i zwraca oldChild. Argumenty muszą być węzłami, nie napisami. To API DOM, nie funkcja ECMAScript.
Istniejący newChild jest przenoszony, nie kopiowany. DocumentFragment wstawia swoje dzieci zamiast samego fragmentu.
Niedozwolona struktura, np. cykl, może spowodować HierarchyRequestError. Metoda sprawdza, czy zastąpienie utworzyłoby cykl, zanim sprawdzi, czy oldChild jest bezpośrednim dzieckiem parent. Jeśli wcześniejsze kontrole nie wykryją błędu, a oldChild nie jest bezpośrednim dzieckiem parent, metoda zgłasza NotFoundError.
Przykłady
const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);
const removedNode = parent.replaceChild(newChild, oldChild);
console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);Wynik
new true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.