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.