Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
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 julho de 2015.
Introdução
O métodounshift() adiciona um ou mais elementos no início de um array e retorna o número de elementos (propriedadelength) atualizado.
Sintaxe
arr.unshift([element1[, ...[, elementN]]])
Parâmetros
elementNOs elementos a serem adicionados no começo do array.
Retorna
A nova propriedadelength do objeto acima onde o método foi chamado.
Descrição
O métodounshift insere os valores fornecidos no início de um objeto do tipo array.
unshift é intencionalmente genérico; este método pode ser chamado viacall ouapply em objetos que se assemelham aos arrays. Objetos que não contêm uma propriedadelength 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 |