Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.prepend — inserire all’inizio di un elemento

Element.prepend inserisce nodi e testo prima del primo figlio di un elemento. Se a e b sono elementi distinti, prepend(a, b, a) inserisce prima b e poi a, senza duplicare a.

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

Sintassi

element.prepend(...nodes)

Element.prepend è un metodo DOM del mixin ParentNode, non una funzione ECMAScript. Accetta nodi e stringhe; restituisce undefined.

Gli argomenti vengono inseriti prima del primo figlio, anche se è un nodo di testo. Le stringhe diventano nodi Text, non markup HTML. I nodi esistenti vengono spostati, non copiati.

La violazione dei vincoli di gerarchia dell’albero genera HierarchyRequestError. L’esempio richiede un ambiente DOM; la sola versione di Node.js non dimostra che questo metodo sia disponibile.

Esempi

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

Risultato

Start | End
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti