CKTIS / JavaScript
Node.insertBefore — vloženie pred potomka
Node.insertBefore vloží alebo presunie uzol pred určeného potomka. Odovzdanie hodnoty null znamená vloženie na koniec.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
parent.insertBefore(node, child)Volá sa na rodičovi: parent.insertBefore(node, child). child musí byť jeho priamym potomkom alebo musí mať hodnotu null (vtedy sa uzol pridá na koniec). Zadajte oba argumenty. Metóda vráti node.
Existujúci uzol sa presunie, nie skopíruje. Pri DocumentFragment sa vložia jeho potomkovia; vrátený fragment je prázdny.
Nepovolená hierarchia, napríklad cyklus, spôsobí HierarchyRequestError. Metóda overuje, či by vložením vznikol cyklus, skôr než overí, či child patrí rodičovi. Ak by vložením vznikol cyklus, metóda vyvolá HierarchyRequestError, aj keď child rodičovi nepatrí. Ak predchádzajúce kontroly prejdú a child nie je ani null, ani priamy potomok rodiča, metóda vyvolá NotFoundError. Ide o API DOM, nie ECMAScriptu; samotná prítomnosť Node.js 24 nedokazuje, že je DOM dostupné.
Príklady
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);Výsledok
AB true BA
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.