Document: prepend()-Methode
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
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)
Parameter
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
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.
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:
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