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.