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

<noinclude>{{DISPLAYTITLE:<code>Array.isArray()‎</code>}}</noinclude>
الدالة <code>Array.isArray()‎</code> تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي مصفوفة أم لا.<syntaxhighlight lang="javascript">
Array.isArray([1, 2, 3]);  // true
Array.isArray({foo: 123}); // false
Array.isArray('foobar');   // false
Array.isArray(undefined);  // false

</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="javascript">
Array.isArray(obj)

</syntaxhighlight>

=== <code>obj</code> ===
الكائن الذي سنختبره.

=== القيمة المعادة ===
<code>true</code> إذا كان <code>obj</code> مصفوفةً، وإلا فستُعاد القيمة <code>false</code>.

== أمثلة ==

=== اختبار مختلف أنواع القيم ===
<syntaxhighlight lang="javascript">
// جميع القيم الآتية هي مصفوفات
Array.isArray([]);
Array.isArray([1]);
Array.isArray(new Array());
Array.isArray(new Array('a', 'b', 'c', 'd'));
Array.isArray(new Array(3));
// Array.prototype هو مصفوفة
Array.isArray(Array.prototype); 

// جميع القيم الآتية ليست مصفوفة
Array.isArray();
Array.isArray({});
Array.isArray(null);
Array.isArray(undefined);
Array.isArray(17);
Array.isArray('Array');
Array.isArray(true);
Array.isArray(false);
Array.isArray({ __proto__: Array.prototype });

</syntaxhighlight>

=== المعامل <code>[[JavaScript/instanceof|instanceof]]</code> والدالة <code>isArray</code> ===
عند التحقق إذا كان أحد الكائنات مصفوفةً، فمن المُفضَّل استخدام الدالة <code>Array.isArray</code> بدلًا من المعامل <code>[[JavaScript/instanceof|instanceof]]</code> لأنها تعمل على الإطارات <code>iframes</code>.<syntaxhighlight lang="javascript">
var iframe = document.createElement('iframe');
document.body.appendChild(iframe);
xArray = window.frames[window.frames.length-1].Array;
var arr = new xArray(1,2,3); // [1,2,3]

// التحقق من المصفوفة
Array.isArray(arr);  // true
// لا تفعل هذا لأنها لن تعمل
arr instanceof Array; // false

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
أُضيفَت الدالة <code>Array.from</code> أوّل مرة في معيار ECMAScript 5، وهذا يعني أنَّ هنالك بعض المتصفحات التي لم تدعم هذه الدالة بعد، لكن يمكن الالتفاف على هذه المشكلة باستخدام الشيفرة الآتية:<syntaxhighlight lang="javascript">
if (!Array.isArray) {
  Array.isArray = function(arg) {
    return Object.prototype.toString.call(arg) === '[object Array]';
  };
}
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|5
|4
|9
|10.5
|5
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-array.isarray ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-array.isarray ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.4.3.2 ECMAScript 5.1]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Array|{{SUBPAGENAME}}]]