Element: before()-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.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