CKTIS / JavaScript
Element.replaceChildren() — замяна на всички дъщерни възли
Element.replaceChildren() заменя дъщерните възли на елемент с възлите и низовете, подадени като аргументи. Извикването без аргументи премахва всички дъщерни възли.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.replaceChildren(...nodes)Element.replaceChildren произлиза от миксина ParentNode на стандарта DOM, а не от ECMAScript. Методът заменя всички дъщерни възли на елемент, като самият елемент остава непокътнат. Връща undefined.
Аргументите са възли или низове и се обработват в реда, в който са подадени. Низовете стават възли Text, а не се анализират като HTML. Съществуващите възли се преместват, а не се клонират. Ако един и същ възел се подаде повторно, той се премества, вместо да се добави още един дъщерен възел. Ако a и b са различни елементи, след извикването на element.replaceChildren(a, b, a) остават b и след него a. element.replaceChildren() премахва всички дъщерни възли.
Невалидна йерархия, например вмъкване на елемент в самия него, хвърля DOMException с име HierarchyRequestError.
Това е API на DOM в браузъра; наличието на Node 24 не доказва, че API е достъпно. Проверете typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function' в целевата среда.
Примери
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);Резултат
Status: New 2 true 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.