Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje