DocumentFragment: replaceChildren()-Methode

Die DocumentFragment.replaceChildren()-Methode ersetzt die vorhandenen Kinder eines DocumentFragment durch einen festgelegten neuen Satz von Kindern. Diese können Zeichenketten oder Node-Objekte sein.

Syntax

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

Parameter

param1, …, paramN: Eine Reihe von Node-Objekten oder Zeichenketten, mit denen die vorhandenen Kinder des DocumentFragment ersetzt werden sollen. Wenn keine Ersetzungsobjekte angegeben sind, wird das DocumentFragment von allen Kindknoten geleert.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException: Wird ausgelöst, wenn die Einschränkungen des Knotensbaums verletzt werden.

Beispiele

Ein Dokument-Fragment leeren

replaceChildren() bietet eine sehr praktische Möglichkeit, ein Dokument-Fragment von all seinen Kindern zu leeren. Sie rufen es für das Dokument-Fragment ohne Angabe von Argumenten auf:

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 []

Spezifikationen

Specification
DOM Standard # ref-for-dom-parentnode-replacechildren①

Browser-Kompatibilität

BCD tables only load in the browser