Array.prototype.unshift()

BaselineWidely 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é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

elementN: Os 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]