CKTIS / JavaScript
Element.replaceWith — замяна на елемент
Element.replaceWith заменя елемент в родителя му с възли и текст. Низовете се превръщат в текст, а не в HTML маркировка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.replaceWith(...nodes)Element.replaceWith идва от миксина ChildNode в стандарта DOM, а не от издание на ECMAScript. Извикването element.replaceWith(...nodes) заменя самия елемент, а не децата му; replaceChildren(...nodes) променя децата.
Аргументите са възли и низове в посочения ред. Възлите се преместват, а не се копират; низовете създават възли Text, без да се анализира HTML. Методът връща undefined. Извикване без аргументи премахва елемента; ако той няма родител, не се извършват промени.
Невалидна дървовидна структура може да причини HierarchyRequestError. Проверете наличността с typeof Element.prototype.replaceWith === 'function' в среда с DOM; само версията на Node.js не доказва, че функцията се поддържа.
Примери
const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);
const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');
console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);Резултат
new <text> true true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.