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

Syntax

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

Parameter

param1, …, paramN

Eine Gruppe von Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

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

Beispiele

Ein Element voranstellen

js
let div = document.createElement("div");
let p = document.createElement("p");
let span = document.createElement("span");
div.append(p);
div.prepend(span);

console.log(div.childNodes); // NodeList [ <span>, <p> ]

Text voranstellen

js
let div = document.createElement("div");
div.append("Some text");
div.prepend("Headline: ");

console.log(div.textContent); // "Headline: Some text"

Ein Element und Text voranstellen

js
let div = document.createElement("div");
let p = document.createElement("p");
div.prepend("Some text", p);

console.log(div.childNodes); // NodeList [ #text "Some text", <p> ]

Die prepend-Methode ist nicht einfügbar

Die prepend()-Methode ist nicht in die with-Anweisung eingefügt. Weitere Informationen finden Sie unter Symbol.unscopables.

js
let div = document.createElement("div");

with (div) {
  prepend("foo");
}
// ReferenceError: prepend is not defined

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch