Array.prototype.unshift în JavaScript

Tablouri (array) Toate browserele, Node.js

Adaugă unul sau mai multe elemente la începutul tabloului și returnează noua lungime.

Sintaxă
tablou.unshift(element1, element2, ...)

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 unshift crezâ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.