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
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

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

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 3rd Edition.