Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.before() — wstawianie przed elementem

Element.before() wstawia węzły i tekst do rodzica elementu, a nie do samego elementu. Zwykle trafiają one przed element odniesienia.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.before(...nodes)

Element.before to metoda DOM z domieszki ChildNode, nie funkcja ECMAScript. Wywołanie element.before(...nodes) przyjmuje węzły i ciągi znaków; ciągi stają się węzłami Text, nie kodem HTML.

Istniejące węzły są przenoszone, nie kopiowane. Jeśli przekażesz jako argument sam element odniesienia, on również może zostać przeniesiony. Jeśli rodzicem target jest węzeł typu Element lub DocumentFragment, wywołanie target.before(target, 'x') umieszcza tekst po target, a nie przed nim. Jeśli target jest elementem głównym dokumentu, to samo wywołanie zgłasza HierarchyRequestError: do węzła Document nie można wstawić fragmentu zawierającego węzeł Text bezpośrednio wśród swoich dzieci. Po pomyślnym wykonaniu metoda zwraca undefined.

Element bez rodzica pozostaje bez zmian; rodzic nie musi należeć do dokumentu. Niedozwolona hierarchia powoduje HierarchyRequestError. W odróżnieniu od parent.insertBefore(node, element) metodę wywołujesz na elemencie odniesienia.

Przykłady

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);

Wynik

A + B
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła