CKTIS / JavaScript
Element.before() — vstavljanje pred element
Element.before() vstavi vozlišča in besedilo v nadrejeno vozlišče, ne v sam element. Običajno jih vstavi pred referenčni element.
Različica: 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 je metoda DOM iz mixina ChildNode, ne funkcija ECMAScripta. element.before(...nodes) sprejme vozlišča in nize; nizi postanejo vozlišča Text, ne HTML.
Obstoječa vozlišča se premaknejo, ne kopirajo. Če kot argument podaš sam referenčni element, se lahko premakne tudi ta. Če je nadrejeno vozlišče elementa target tipa Element ali DocumentFragment, klic target.before(target, 'x') vstavi besedilo za target, ne pred njega. Če je target korenski element dokumenta, isti klic sproži izjemo HierarchyRequestError: fragmenta, ki ima vozlišče Text za neposrednega potomca, ni mogoče vstaviti v vozlišče Document. Ob uspešnem klicu metoda vrne undefined.
Element brez nadrejenega vozlišča ostane nespremenjen; nadrejeno vozlišče ni nujno del dokumenta. Neveljavna hierarhija povzroči HierarchyRequestError. Za razliko od parent.insertBefore(node, element) to metodo pokličeš na referenčnem elementu.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju prav te različice.