CKTIS / JavaScript
Node.replaceChild — замяна на дъщерен възел
Node.replaceChild заменя пряк дъщерен възел на родителския и връща премахнатия възел. Заместващият възел се подава като първи аргумент.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) заменя oldChild с newChild и връща oldChild. Аргументите трябва да са възли, а не низове. Това е DOM API, а не функция на ECMAScript.
Ако newChild вече съществува, той се премества, а не се копира. DocumentFragment вмъква дъщерните си възли, а не самия фрагмент.
Невалидна структура, например цикъл, може да причини HierarchyRequestError. Методът проверява дали замяната би създала цикъл, преди да провери дали oldChild е пряк дъщерен възел на parent. Ако предходните проверки не открият грешка и oldChild не е пряк дъщерен възел на parent, методът хвърля изключение NotFoundError.
Примери
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);Резултат
new true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.