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

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

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

Източници