Document: append() Methode

Die Document.append()-Methode fügt eine Reihe von Node-Objekten oder Zeichenketten nach dem letzten Kind des Dokuments ein. Zeichenketten werden als gleichwertige Text-Knoten eingefügt.

Diese Methode fügt ein Kind zu einem Document hinzu. Um ein Kind zu einem beliebigen Element im Baum hinzuzufügen, siehe Element.append().

Syntax

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

Parameter

param1, …, paramN: Eine Reihe von Node-Objekten oder Zeichenketten, die eingefügt werden sollen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException: Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.

Beispiele

Einfügen eines Wurzelelements in ein Dokument

Wenn Sie versuchen, ein Element in ein bestehendes HTML-Dokument einzufügen, kann es einen HierarchyRequestError DOMException auslösen, da ein <html>-Element bereits existiert.

let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.

Wenn Sie ein neues Dokument ohne bestehende Elemente erstellen, können Sie ein HTML-Wurzelelement (oder ein SVG-Wurzelelement) einfügen:

let doc = new Document();
let html = document.createElement("html");
doc.append(html);

doc.children; // HTMLCollection [<html>]

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser