База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници