CharacterData: метод replaceWith()

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

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

Метод replaceWith() интерфейса CharacterData заменяет данный узел в списке дочерних узлов его родителя наборами объектов Node или строк.

Строки вставляются как узлы Text; строка передаётся в качестве аргумента конструктору Text().

Синтаксис

replaceWith(...nodes)

Параметры

nodes Необязательно: Список, разделённый запятыми, объектов Node или строк, которые заменят текущий узел.

Примечание: Если аргументы не переданы, этот метод удаляет узел из дерева DOM.

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

None (undefined).

Исключения

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

Примеры

<p id="myText">Some text</p>

let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";

text.replaceWith(em); // Replace `Some text` by `Italic text`

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для 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/CharacterData/replaceWith