Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri