База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и посоченият резултат са проверени в изолирана среда по метода, документиран в доказателството за проверка на точно тази версия.

Източници