CKTIS / JavaScript
Element.before() — umetanje prije elementa
Element.before() umeće čvorove i tekst u roditeljski čvor, a ne u sam element. Obično ih umeće ispred referentnog elementa.
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
element.before(...nodes)Element.before metoda je DOM-a iz mixina ChildNode, a ne funkcija ECMAScripta. element.before(...nodes) prihvaća čvorove i nizove znakova; nizovi postaju čvorovi Text, a ne HTML.
Postojeći čvorovi premještaju se, ne kopiraju. Ako kao argument proslijediš sam referentni element, i on se može premjestiti. Ako je roditeljski čvor elementa target tipa Element ili DocumentFragment, poziv target.before(target, 'x') umeće tekst iza elementa target, a ne ispred njega. Ako je target korijenski element dokumenta, isti poziv baca iznimku HierarchyRequestError: fragment koji ima čvor Text kao neposrednog potomka ne može se umetnuti u čvor Document. Ako poziv uspije, metoda vraća undefined.
Element bez roditelja ostaje nepromijenjen; roditelj ne mora pripadati dokumentu. Nevaljana hijerarhija uzrokuje HierarchyRequestError. Za razliku od parent.insertBefore(node, element), ovu metodu pozivaš na referentnom elementu.
Primjeri
const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);
const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');
console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);Rezultat
A + B true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu o provjeri upravo te verzije.