Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Node.insertBefore — wstawianie przed dzieckiem

Node.insertBefore wstawia lub przenosi węzeł przed wskazane dziecko. Przekazanie null oznacza wstawienie na końcu.

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

Składnia

parent.insertBefore(node, child)

Node.insertBefore wywołuje się na rodzicu: parent.insertBefore(node, child). child musi być jego bezpośrednim dzieckiem albo null (wstawienie na końcu). Podawaj oba argumenty. Metoda zwraca node.

Istniejący węzeł jest przenoszony, nie kopiowany. Dla DocumentFragment wstawiane są jego dzieci; zwracany fragment pozostaje pusty.

Niedozwolona hierarchia, np. cykl, powoduje HierarchyRequestError. Metoda sprawdza, czy wstawienie utworzyłoby cykl, zanim sprawdzi, czy child należy do rodzica. Jeśli wstawienie utworzyłoby cykl, zgłasza HierarchyRequestError, nawet gdy child nie należy do rodzica. Jeśli wcześniejsze sprawdzenia przejdą pomyślnie, child inny niż null, który nie jest bezpośrednim dzieckiem rodzica, powoduje NotFoundError. To API DOM, nie ECMAScript; sama obecność Node.js 24 nie dowodzi dostępności DOM.

Przykłady

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);

Wynik

AB
true
BA

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła