Dokument: 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 April 2018.

Die Document.prepend()-Methode fügt eine Reihe von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein. Zeichenfolgen werden als gleichwertige Text-Knoten eingefügt.

Diese Methode stellt ein Kind einem Document voran. Um ein Element an einer beliebigen Stelle im Baum voranzustellen, siehe Element.prepend().

Syntax

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

Parameter

param1, …, paramN: Eine Reihe von Node-Objekten oder Zeichenfolgen, 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

Ein Wurzelelement in ein Dokument voranstellen

Wenn Sie versuchen, ein Element einem bestehenden HTML-Dokument voranzustellen, könnte ein HierarchyRequestError DOMException auftreten, wenn bereits ein <html>-Element existiert.

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 Wurzel-HTML-Element (oder ein Wurzel-SVG-Element) voranstellen:

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

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

Spezifikationen

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