Element.prepend() — Methode · JavaScript-Referenz

Signatur

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

Beschreibung

Die Methode Element.prepend() fügt eine Reihe von Node-Objekten oder Strings vor dem ersten Kind des Element ein. Strings werden als äquivalente Text-Knoten eingefügt.

Parameter

Name	Typ	Default	Beschreibung
$param1, …, paramN Pflicht	Node \| string	—	Eine Reihe von `Node`-Objekten oder Strings, die eingefügt werden sollen.

Rückgabewert

Typ

undefined

Beschreibung

Keiner (undefined).

Beispiele

Ein Element voranstellen

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

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

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

Ein Element und Text voranstellen

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 unscopable

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

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

// Wichtig · Fallstricke

Ausnahmen: Ein HierarchyRequestError (DOMException) wird geworfen, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann. Die Methode prepend() ist nicht in die with-Anweisung eingebunden. Siehe Symbol.unscopables für weitere Informationen.

Siehe auch

Element.append() Node.appendChild() Node.insertBefore() Element.before() Element.insertAdjacentElement() NodeList FileSystemEntry.remove()