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

CKTIS / JavaScript

Element.before() — vložení před element

Element.before() vkládá uzly a text do rodičovského uzlu, nikoli do samotného elementu. Obvykle je vloží před referenční element.

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

element.before(...nodes)

Element.before je metoda DOM z mixinu ChildNode, nikoli funkce ECMAScriptu. element.before(...nodes) přijímá uzly a řetězce; řetězce se převádějí na uzly Text, nikoli na HTML.

Existující uzly se přesouvají, nekopírují. Pokud jako argument předáš samotný referenční element, může se přesunout i ten. Pokud je rodičem target uzel typu Element nebo DocumentFragment, volání target.before(target, 'x') umístí text za target, nikoli před něj. Je-li target kořenovým elementem dokumentu, stejné volání vyvolá výjimku HierarchyRequestError: fragment s uzlem Text jako přímým potomkem nelze vložit do uzlu Document. Při úspěšném volání metoda vrací undefined.

Element bez rodiče zůstane beze změny; rodič nemusí patřit do dokumentu. Neplatná hierarchie způsobí HierarchyRequestError. Na rozdíl od parent.insertBefore(node, element) voláš tuto metodu na referenčním elementu.

Příklady

const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);

const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');

console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);

Výsledek

A + B
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření právě této verze.

Zdroje