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
HierarchyRequestErrorDOMException-
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① |
Browser-Kompatibilität
Loading…