مثال (متد unshift)

اضافه کردن آیتم های جدید به ابتدای یک آرایه:

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.unshift("Lemon","Pineapple");

خروجی fruits در کد بالا:

Lemon,Pineapple,Banana,Orange,Apple,Mango

خودتان امتحان کنید »

تعریف و کاربرد

متد unshift()، آیتم های جدیدی را به ابتدای یک آرایه اضافه می کند و طول جدید آرایه را برمی گرداند.

نکته: این متد طول آرایه را تغییر می دهد.

نکته: برای اضافه کردن آیتم های جدید به انتهای یک آرایه، از متد push() استفاده کنید.

پشتیبانی مرورگرها

اعداد داخل جدول زیر نشان دهنده ی اولین ورژن مرورگری است که به طور کامل از این رویداد پشتیبانی می کند.

متد     
unshift() 1.0 5.5 1.0 بله بله

متد unshift() در Internet Explorer 8 و ورژن های پایین تر از آن، undefined را برمی گرداند.

نحوه استفاده

array.unshift(item1,item2, ..., itemX)

مقادیر پارامترها

پارامترتوضیحات
item1,item2, ..., itemX

ضروری. آیتم هایی که می خواهیم به ابتدای یک آرایه اضافه کنیم.

جزئیات تکنیکی

مقدار برگشتی

یک عدد که طول جدید آرایه را مشخص می کند.
نسخه JavaScript 1.2

مرجع آرایه ها در JavaScript مرجع آرایه ها در JavaScript