title | short-title | slug | page-type | browser-compat |
---|---|---|---|---|
DocumentFragment: replaceChildren() method |
replaceChildren() |
Web/API/DocumentFragment/replaceChildren |
web-api-instance-method |
api.DocumentFragment.replaceChildren |
{{APIRef("DOM")}}
The DocumentFragment.replaceChildren()
method replaces the
existing children of a DocumentFragment
with a specified new set of children. These
can be string or {{domxref("Node")}} objects.
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
param1
, …,paramN
- : A set of {{domxref("Node")}} or string objects to replace the
DocumentFragment
's existing children with. If no replacement objects are specified, then theDocumentFragment
is emptied of all child nodes.
- : A set of {{domxref("Node")}} or string objects to replace the
None ({{jsxref("undefined")}}).
HierarchyRequestError
{{DOMxRef("DOMException")}}- : Thrown when the constraints of the node tree are violated.
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}}
{{Compat}}
- {{domxref("DocumentFragment.prepend()")}}
- {{domxref("DocumentFragment.append()")}}