Objeto
Array Método unshift
Adiciona um elemento ao início de um array. É
possível adicionar vários elementos ao mesmo tempo.
Se qualquer dos argumentos for do tipo array, este será
adicionado como um elemento individual. Após a chamada
ao método unshift, o tamanho do array
é aumentado na quantidade de elementos que foram adicionados.
Sintaxe:
array.unshift(item);
Onde array é o nome do array ao qual
o elemento será adicionado e item é
o elemento a ser adicionado no início do array.
Exemplo 1 – Como adicionar um elemento
ao início de um array:
<script language="javascript">
<!--
var valores = new Array(1, 2, 3, 4, 5);
document.write("Valores no Array: " +
valores + "<br>");
valores.unshift(6);
document.write("Adicionei um novo elemento
no início do array<br>");
document.write("Valores no Array: " +
valores);
//-->
</script>
A execução deste código produzirá
o seguinte resultado: Valores
no Array: 1,2,3,4,5
Adicionei um novo elemento no início do array
Valores no Array: 6,1,2,3,4,5 Exemplo
2 – Adicionando três elementos no início
de um array:
<script language="javascript">
<!--
var valores = new Array(1, 2, 3, 4, 5);
document.write("Valores no Array: " +
valores + "<br>");
valores.unshift(6, 7, 8);
document.write("Adicionei três elementos
no início do array<br>");
document.write("Valores no Array: " +
valores);
//-->
</script>
A execução deste código produzirá
o seguinte resultado: Valores
no Array: 1,2,3,4,5
Adicionei três elementos no início do array
Valores no Array: 6,7,8,1,2,3,4,5 |