DocumentFragment: метод replaceChildren()

Метод DocumentFragment.replaceChildren() заменяет существующих потомков DocumentFragment на указанный новый набор потомков. Они могут быть строками или объектами Node.

param1, …, paramN

Набор объектов Node или строк, которыми будут заменены существующие потомки DocumentFragment. Если объекты для замены не указаны, то DocumentFragment очищается от всех дочерних узлов.

None (undefined).

HierarchyRequestError DOMException

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

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

let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);

fragment.children; // HTMLCollection [<div>, <p>]

fragment.replaceChildren();

fragment.children; // HTMLCollection []

• DocumentFragment.prepend()
• DocumentFragment.append()