WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Node.insertBefore — vor einem Kindknoten einfügen

Node.insertBefore fügt einen Knoten vor einem angegebenen Kindknoten ein oder verschiebt ihn dorthin. Wird null übergeben, wird der Knoten am Ende eingefügt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

parent.insertBefore(node, child)

Rufe Node.insertBefore auf dem Elternknoten auf: parent.insertBefore(node, child). child muss ein direktes Kind des Elternknotens oder null sein (dann wird der Knoten angehängt). Gib beide Argumente an. Die Methode gibt node zurück.

Ein bereits vorhandener Knoten wird verschoben, nicht kopiert. Bei einem DocumentFragment werden dessen Kinder eingefügt; das zurückgegebene Fragment ist leer.

Eine unzulässige Hierarchie, etwa ein Zyklus, führt zu HierarchyRequestError. Die Methode prüft zuerst, ob beim Einfügen ein Zyklus entstehen würde, und erst danach, ob child zum Elternknoten gehört. Würde ein Zyklus entstehen, löst sie HierarchyRequestError aus, auch wenn child nicht zum Elternknoten gehört. Sind die vorherigen Prüfungen erfolgreich und ist child weder null noch ein direktes Kind des Elternknotens, löst sie NotFoundError aus. Dies ist eine DOM-API, kein Bestandteil von ECMAScript; Node.js 24 allein belegt nicht, dass das DOM verfügbar ist.

Beispiele

const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);

Ergebnis

AB
true
BA

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen