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.