CKTIS / JavaScript
Element.before() — вмъкване преди елемент
Element.before() вмъква възли и текст в родителския възел, а не в самия елемент. Обикновено ги вмъква преди референтния елемент.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.before(...nodes)Element.before е DOM метод от миксина ChildNode, а не функция на ECMAScript. element.before(...nodes) приема възли и низове; низовете стават възли Text, а не HTML.
Съществуващите възли се преместват, а не се копират. Ако подадеш самия референтен елемент като аргумент, той също може да бъде преместен. Ако родителят на target е възел от тип Element или DocumentFragment, извикването target.before(target, 'x') поставя текста след target, а не преди него. Ако target е кореновият елемент на документа, същото извикване хвърля изключение HierarchyRequestError: фрагмент с възел Text като пряко дете не може да се вмъкне във възел Document. При успешно извикване методът връща undefined.
Елемент без родител остава непроменен; родителят не е задължително да принадлежи на документа. Невалидна йерархия причинява HierarchyRequestError. За разлика от parent.insertBefore(node, element), този метод се извиква върху референтния елемент.
Примери
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);Резултат
A + B true true
Показаният код и посоченият резултат са проверени в изолирана среда по метода, документиран в доказателството за проверка на точно тази версия.