DocumentFragment.replaceChildren()
The DocumentFragment.replaceChildren()
method replaces the
existing children of a DocumentFragment
with a specified new set of children. These
can be DOMString
or Node
objects.
Syntax
replaceChildren(...nodesOrDOMStrings)
Parameters
Exceptions
HierarchyRequestError
DOMException
-
Thrown when the nhe constraints of the node tree are violated.
Examples
Emptying a document fragment
replaceChildren()
provides a very convenient mechanism for emptying a document fragment
of all its children. You call it on the document fragment without any argument specified:
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 []
Specifications
Specification |
---|
DOM Standard # ref-for-dom-parentnode-replacechildrenā |
Browser compatibility
BCD tables only load in the browser