CKTIS / JavaScript
Node.insertBefore — vložení před potomka
Node.insertBefore vloží nebo přesune uzel před určeného potomka. Předání hodnoty null znamená vložení na konec.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
parent.insertBefore(node, child)Volá se na rodiči: parent.insertBefore(node, child). child musí být jeho přímým potomkem, nebo musí mít hodnotu null (pak se uzel připojí na konec). Zadejte oba argumenty. Metoda vrací node.
Existující uzel se přesune, nikoli zkopíruje. U DocumentFragment se vloží jeho potomci; vrácený fragment je prázdný.
Nepovolená hierarchie, například cyklus, způsobí HierarchyRequestError. Metoda ověřuje, zda by vložením vznikl cyklus, dříve než ověří, zda child patří rodiči. Pokud by vložením vznikl cyklus, metoda vyvolá HierarchyRequestError, i když child rodiči nepatří. Pokud předchozí kontroly projdou a child není ani null, ani přímý potomek rodiče, metoda vyvolá NotFoundError. Jde o API DOM, nikoli ECMAScriptu; samotná přítomnost Node.js 24 nedokazuje, že je DOM dostupné.
Pří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ýsledek
AB true BA
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.