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.