Элемент: метод replaceWith()

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод Element.replaceWith() заменяет этот Element в списке дочерних элементов родителя на набор объектов Node или строк. Строки вставляются как эквивалентные узлы Text.

Синтаксис

replaceWith(param1)
replaceWith(param1, param2)
replaceWith(param1, param2, /* …, */ paramN)

Параметры

param1, …, paramN: Набор объектов Node или строк для замены.

Возвращаемое значение

None (undefined).

Исключения

HierarchyRequestError DOMException: Выбрасывается, когда узел нельзя вставить в указанную точку иерархии.

Примеры

Использование `replaceWith()`

const div = document.createElement("div");
const p = document.createElement("p");
div.appendChild(p);
const span = document.createElement("span");

p.replaceWith(span);

console.log(div.outerHTML);
// "<div><span></span></div>"

`replaceWith()` не может быть ограничено областью видимости

Метод replaceWith() не включён в область видимости оператора with. См. Symbol.unscopables для получения дополнительной информации.

with (node) {
  replaceWith("foo");
}
// ReferenceError: replaceWith is not defined

Спецификации

Спецификация
DOM # ref-for-dom-childnode-replacewith①

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`replaceWith`	54	17	49	39	10	54	49	41	10	6.0	54

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceWith