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

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

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

Източници