Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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.
DieDocument.prepend()-Methode fügt eine Reihe vonNode-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein. Zeichenfolgen werden als gleichwertigeText-Knoten eingefügt.
Diese Methode stellt ein Kind einemDocument voran. Um ein Element an einer beliebigen Stelle im Baum voranzustellen, sieheElement.prepend().
Syntax
prepend(param1)prepend(param1, param2)prepend(param1, param2, /* …, */ paramN)Parameter
param1, …,paramNEine Reihe von
Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMExceptionWird 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 einHierarchyRequestErrorDOMException 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① |