Metode Array.unshift() menambahkan satu atau lebih elemen di depan elemen-elemen yang sudah ada sebelumnya di dalam array. Nilai yang dikembalikan metode ini adalah bilangan bulat yang menunjukkan banyaknya elemen array yang baru sekarang ini.
Sintaks:
arrayObj.unshift(element, ..., elementn)
- Parameter
element, ..., elementndigunakan untuk menetapkan elemen yang akan ditambahkan ke dalam array.
Metode Array.unshift() adalah metode standard JavaScript 1.2+, JScript 3.0+, ECMAScript 3.0+ dan di dukung Google Chrome Beta+, Firefox 1.0 (Gecko 1.7)+, Internet Explorer 5.5+, Netscape Navigator 4.0+, Opera 5.0+, Safari 1.0+.
Contoh di bawah ini menambahkan 4 elemen untuk array numArr:
var numArr = new Array(1,2,3,4,5);
document.write(numArr.unshift(6,7,8,9)); // 9
Contoh di bawah ini menampilkan elemen-elemen dari numArr sebelum dan setelah terkena metode Array.unshift() ke dalam halaman:
var numArr = new Array(1,2,3,4,5);
document.write("Sebelum di-unshift: "+numArr);
document.write("<BR>");
var unshifted = numArr.unshift(6,7,8,9);
document.write("Setelah di-unshift: "+numArr);
Output contoh program di atas:
Sebelum di-unshift: 1,2,3,4,5Setelah di-unshift: 6,7,8,9,1,2,3,4,5
