Array.prototype.unshift()
< JavaScript | Array
اذهب إلى التنقل
اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
الدالة 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.