CKTIS / JavaScript
Node.insertBefore — umetanje prije čvora djeteta
Node.insertBefore umeće ili premješta čvor prije navedenog djeteta. Ako se preda null, čvor se umeće na kraj.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
parent.insertBefore(node, child)Pozovite Node.insertBefore na roditelju: parent.insertBefore(node, child). child mora biti njegovo izravno dijete ili null (za dodavanje čvora na kraj). Navedite oba argumenta. Metoda vraća node.
Postojeći čvor premješta se, a ne kopira. Kod DocumentFragment umeću se njegova djeca; vraćeni fragment je prazan.
Nedopuštena hijerarhija, primjerice ciklus, uzrokuje HierarchyRequestError. Metoda provjerava bi li umetanjem nastao ciklus prije nego što provjeri pripada li child roditelju. Ako bi umetanjem nastao ciklus, metoda baca HierarchyRequestError čak i ako child ne pripada roditelju. Ako prethodne provjere prođu, a child nije ni null ni izravno dijete roditelja, metoda baca NotFoundError. Ovo je API DOM-a, a ne ECMAScripta; sama prisutnost Node.js 24 ne dokazuje da je DOM dostupan.
Primjeri
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);Rezultat
AB true BA
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.