Document: prepend()-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 Methode Document.prepend() fügt eine Reihe von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein. Zeichenfolgen werden als entsprechende Text-Knoten eingefügt.

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

Syntax

js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)

Parameter

param1, …, paramN

Eine Reihe von Node-Objekten oder Zeichenfolgen zum Einfügen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

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

Beispiele

Ein Wurzelelement zu einem Dokument voranstellen

Wenn Sie versuchen, einem bestehenden HTML-Dokument ein Element voranzustellen, könnte ein HierarchyRequestError DOMException ausgelöst werden, da möglicherweise bereits ein <html>-Element existiert.

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

Wenn Sie ein neues Dokument ohne vorhandene Elemente erstellen, können Sie ein HTML-Wurzelelement (oder ein SVG-Wurzelelement) voranstellen:

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

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch