Array.prototype.unshift()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث
الدالة Array.prototype.unshift()‎ تضيف عنصرًا أو أكثر إلى بداية مصفوفة وتُعيد عدد عناصر (length) المصفوفة.
var a = [1, 2, 3];
a.unshift(4, 5);

console.log(a); // [4, 5, 1, 2, 3]

البنية العامة

arr.unshift(element1[, ...[, elementN]])

elementN

العناصر التي ستُضاف إلى بداية المصفوفة.

القيمة المعادة

قيمة الخاصية length الجديدة للمصفوفة التي استدعيت هذه الدالة عليها.

أمثلة

var arr = [1, 2];

arr.unshift(0); // الناتج هو 3، وهو عدد عناصر المصفوفة الجديدة
// arr: [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr: [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr: [[-3], -2, -1, 0, 1, 2]

دعم المتصفحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم نعم نعم نعم نعم

مصادر ومواصفات