Document: append() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

js
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:

js
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

Siehe auch