Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.replaceChildren() — zastępowanie wszystkich dzieci

Element.replaceChildren() zastępuje dzieci elementu węzłami i tekstem podanymi jako argumenty. Wywołanie bez argumentów usuwa wszystkie dzieci.

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

element.replaceChildren(...nodes)

Element.replaceChildren pochodzi z miksinu ParentNode standardu DOM, nie z ECMAScript. Zastępuje wszystkie dzieci elementu, pozostawiając sam element. Zwraca undefined.

Argumentami są węzły lub ciągi znaków, przetwarzane w podanej kolejności. Ciągi stają się węzłami Text, a nie kodem HTML. Istniejące węzły są przenoszone, nie klonowane. Ponowne podanie tego samego węzła przenosi go zamiast dodawać drugie dziecko. Jeśli a i b to dwa różne elementy, po wywołaniu element.replaceChildren(a, b, a) dziećmi elementu są kolejno b i a. element.replaceChildren() usuwa wszystkie dzieci.

Niedozwolona hierarchia, na przykład wstawienie elementu do niego samego, powoduje DOMException o nazwie HierarchyRequestError.

To API przeglądarkowego DOM; obecność Node 24 nie dowodzi jego dostępności. W środowisku docelowym sprawdź typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Przykłady

const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';

box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);

box.replaceChildren();
console.log(box.childNodes.length);

Wynik

Status: New
2
true
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła