English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método unshift() do Array JavaScript

 Objeto Array do JavaScript

unshift()O método adiciona um ou mais elementos no início do array e retorna o novo comprimento do array.

Atenção:Para adicionar um novo elemento ao final do array, usepush()Método.

Sintaxe:

array.unshift(element1, ..., elementN)
var fruits = ["Banana", "Mango", "Maçã"];
fruits.unshift("Strawberry");
Teste e veja‹/›

Compatibilidade do Navegador

Os números na tabela especificam a primeira versão do navegador que suporta completamente o método unshift():

Método
unshift()11SimSim9

Valor do Parâmetro

ParâmetroDescrição
elementNElemento a ser adicionado no início do array

Detalhes Técnicos

Retorno:Retorna o novo comprimento do array
Versão do JavaScript:ECMAScript 1

Mais Exemplos

O seguinte código adiciona três elementos ao array. A variável total contém o novo comprimento do array:

var fruits = ["Banana", "Mango", "Maçã"];
var total = fruits.unshift("Strawberry", "Lychee", "Guava");
Teste e veja‹/›

O seguinte código adiciona o valor do campo de entrada ao array:


Banana, Mango, Maçã

 Objeto Array do JavaScript