Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje