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

CKTIS / JavaScript

Node.insertBefore — vstavljanje pred neposredno podrejeno vozlišče

Node.insertBefore vstavi ali premakne vozlišče pred določenega neposrednega potomca. Če podate null, se vozlišče vstavi na konec.

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

parent.insertBefore(node, child)

Node.insertBefore pokličite na nadrejenem vozlišču: parent.insertBefore(node, child). child mora biti njegov neposredni otrok ali null (v tem primeru se vozlišče doda na konec). Podajte oba argumenta. Metoda vrne node.

Obstoječe vozlišče se premakne, ne kopira. Pri DocumentFragment se vstavijo njegovi otroci; vrnjeni fragment je prazen.

Nedovoljena hierarhija, na primer cikel, povzroči HierarchyRequestError. Metoda preveri, ali bi z vstavljanjem nastal cikel, preden preveri, ali child pripada nadrejenemu vozlišču. Če bi nastal cikel, metoda sproži izjemo HierarchyRequestError, tudi če child ne pripada nadrejenemu vozlišču. Če so predhodna preverjanja uspešna in child ni niti null niti neposredni otrok nadrejenega vozlišča, metoda sproži izjemo NotFoundError. To je API DOM, ne ECMAScript; že sama prisotnost Node.js 24 še ne dokazuje, da je DOM na voljo.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri