Element: before()-Methode

Die Element.before()-Methode fügt eine Reihe von Node-Objekten oder Zeichenfolgen in die Kinderliste des Elternteils dieses Element ein, direkt vor diesem Element. Zeichenfolgen werden als äquivalente Text-Knoten eingefügt.

Syntax

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

Parameter

param1, …, paramN

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

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

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

Beispiele

Einfügen eines Elements

js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");

p.before(span);

console.log(container.outerHTML);
// "<div><span></span><p></p></div>"

Einfügen von Text

js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);

p.before("Text");

console.log(container.outerHTML);
// "<div>Text<p></p></div>"

Einfügen eines Elements und von Text

js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");

p.before(span, "Text");

console.log(container.outerHTML);
// "<div><span></span>Text<p></p></div>"

Spezifikationen

Specification
DOM Standard
# ref-for-dom-childnode-before①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch