Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła