Метод: replaceChildren()

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

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

Метод Document.replaceChildren() заменяет существующих дочерних элементов Document на указанный новый набор дочерних элементов.

Синтаксис

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

Параметры

param1, …, paramN: Набор объектов Node или строк, которыми заменяются существующие дочерние элементы Document. Если объекты для замены не указаны, то Document очищается от всех дочерних узлов.

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

None (undefined).

Исключения

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

Примеры

Очистка документа

replaceChildren() предоставляет удобный механизм для очистки документа от всех дочерних элементов. Вы вызываете его для документа без указания аргументов:

document.replaceChildren();
document.children; // HTMLCollection []

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`replaceChildren`	86	86	78	72	14	86	79	61	14	14.0	86

См. также

© 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/Document/replaceChildren