الفرق بين المراجعتين لصفحة: «JavaScript/Array/unshift»

المراجعة الحالية بتاريخ 15:40، 28 يناير 2018

الدالة 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.

@@ سطر 56: / سطر 56: @@
 * معيار [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]]
+[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Global Objects]]
+[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Array]]
+[[تصنيف:JavaScript Array|{{SUBPAGENAME}}]]