Array.prototype.unshift()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Introdução
O método unshift() adiciona um ou mais elementos no início de um array e retorna o número de elementos (propriedade length) atualizado.
Sintaxe
arr.unshift([element1[, ...[, elementN]]])
Parâmetros
elementN-
Os elementos a serem adicionados no começo do array.
Retorna
A nova propriedade length do objeto acima onde o método foi chamado.
Descrição
O método unshift insere os valores fornecidos no início de um objeto do tipo array.
unshift é intencionalmente genérico; este método pode ser chamado via call ou apply em objetos que se assemelham aos arrays. Objetos que não contêm uma propriedade length que reflete a última de uma série consecutiva de propriedades numéricas, iniciada por 0, podem não comportar-se de maneira significativa.
Exemplos
var arr = [1, 2];
arr.unshift(0); // result of call is 3, the new array length
// arr is [0, 1, 2]
arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]
arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]
Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.unshift |