عرض مصدر JavaScript/Array/unshift

<noinclude>{{DISPLAYTITLE:<code>Array.prototype.unshift()‎</code>}}</noinclude>
الدالة <code>Array.prototype.unshift()‎</code> تضيف عنصرًا أو أكثر إلى بداية مصفوفة وتُعيد عدد عناصر (<code>[[JavaScript/Array/length|length]]</code>) المصفوفة.<syntaxhighlight lang="javascript">
var a = [1, 2, 3];
a.unshift(4, 5);

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

</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="javascript">
arr.unshift(element1[, ...[, elementN]])

</syntaxhighlight>

=== <code>element''N''</code> ===
العناصر التي ستُضاف إلى بداية المصفوفة.

=== القيمة المعادة ===
قيمة الخاصية <code>[[JavaScript/Array/length|length]]</code> الجديدة للمصفوفة التي استدعيت هذه الدالة عليها.

== أمثلة ==
<syntaxhighlight lang="javascript">
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]

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-array.prototype.unshift ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.unshift ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.4.4.13 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf ECMAScript 3rd Edition]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Array|{{SUBPAGENAME}}]]