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

js
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 Language Specification
# sec-array.prototype.unshift

Compatibilidade entre browsers

BCD tables only load in the browser

Veja também