Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.prepend — dodawanie na początku elementu

Element.prepend wstawia węzły i tekst przed pierwszym dzieckiem elementu. Jeśli a i b to różne elementy, prepend(a, b, a) wstawia najpierw b, a potem a, bez tworzenia kopii a.

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.prepend(...nodes)

Element.prepend to metoda DOM z miksinu ParentNode, nie funkcja ECMAScript. Przyjmuje węzły i ciągi znaków; zwraca undefined.

Wstawia argumenty przed pierwszym dzieckiem, również tekstowym. Ciągi stają się węzłami Text, a nie kodem HTML. Istniejące węzły są przenoszone, nie kopiowane.

Naruszenie hierarchii drzewa powoduje HierarchyRequestError. Przykład wymaga środowiska z DOM; sama wersja Node.js nie potwierdza dostępności tej metody.

Przykłady

const container = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'Start';
container.textContent = 'End';
const result = container.prepend(label, ' | ');

console.log(container.textContent);
console.log(container.firstChild === label);
console.log(result === undefined);

Wynik

Start | End
true
true

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

Źródła