Ce face Array.prototype.unshift
unshift este perechea lui push pentru începutul tabloului. Elementele existente sunt mutate spre dreapta, iar tabloul este modificat.
Dacă dai mai multe elemente deodată, ele apar în ordinea în care le-ai scris. Pe tablouri foarte mari, unshift este mai lent decât push, pentru că trebuie să mute toate elementele.
Parametri
| Parametru | Descriere |
|---|---|
element1, element2, ... |
Elementele adăugate la început. |
Ce returnează
Noua lungime a tabloului.
Exemple
Exemplul 1: Adăugare la început
const notificari = ["mesaj vechi"];
console.log(notificari.unshift("mesaj nou"));
console.log(notificari);
notificari.unshift("a", "b");
console.log(notificari);
Rezultat
2
[ 'mesaj nou', 'mesaj vechi' ]
[ 'a', 'b', 'mesaj nou', 'mesaj vechi' ]
Exemplul 2: Istoric limitat la ultimele 3 căutări
const istoric = [];
for (const cautare of ["laptop", "mouse", "monitor", "tastatură"]) {
istoric.unshift(cautare);
if (istoric.length > 3) istoric.pop();
}
console.log(istoric);
Rezultat
[ 'tastatură', 'monitor', 'mouse' ]
Greșeli frecvente
- Salvezi rezultatul lui
unshiftcrezând că este tabloul. Este doar noua lungime.
Comenzi înrudite
push: Adaugă unul sau mai multe elemente la sfârșitul unui tablou.pop / shift: Scoate ultimul element (pop) sau primul element (shift) dintr-un tablou și îl returnează.Array.prototype.splice: Șterge, înlocuiește sau inserează elemente oriunde în tablou, modificând tabloul.