DocumentFragment: replaceChildren() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{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.

Syntax

js-nolint
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)

Parameters

  • param1, …, paramN
  • : A set of {{domxref("Node")}} objects or strings to replace the

DocumentFragment's existing children with. If no replacement objects are specified, then the DocumentFragment is emptied of all child nodes.

Return value

None ({{jsxref("undefined")}}).

Exceptions

  • HierarchyRequestError {{DOMxRef("DOMException")}}
  • : Thrown when the 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:

js
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

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("DocumentFragment.prepend()")}}
  • {{domxref("DocumentFragment.append()")}}