عرض مصدر JavaScript/instanceof

<noinclude>{{DISPLAYTITLE:المعامل <code>instanceof</code> في JavaScript}}</noinclude>
المعامل <code>instanceof</code> يختبر إذا كانت الخاصية <code>prototype</code> لدالة بانية تظهر في أيّ مكان في سلسلة prototype لأحد الكائنات.
==البنية العامة==
<syntaxhighlight lang="javascript">
object instanceof constructor

</syntaxhighlight>

=== <code>object</code> ===
الكائن الذي نريد معرفة إن كانت خاصية <code>prototype</code> للدالة البانية <code>constructor</code> ستظهر في أي مكان في سلسلة prototype الخاصة به.

=== <code>constructor</code> ===
الدالة البانية التي سنختبر الكائن بها.

== الوصف ==
يختبر المعامل <code>instanceof</code> وجود الخاصية <code>constructor.prototype</code> في سلسلة prototype للكائن <code>object</code>.<syntaxhighlight lang="javascript">
// تعريف الدوال البانية
function C() {}
function D() {}

var o = new C();

// true: Object.getPrototypeOf(o) === C.prototype
o instanceof C;

// false, D.prototype ليست موجودةً في سلسلة prototype
o instanceof D;

o instanceof Object; // true, لأن:
C.prototype instanceof Object // true

C.prototype = {};
var o2 = new C();

o2 instanceof C; // true

// false, لأن C.prototype
// ليست موجودةً في سلسلة prototype
// للكائن o
o instanceof C; 

// إضافة الكائن C إلى سلسلة
// prototype للكائن D
D.prototype = new C();
var o3 = new D();
o3 instanceof D; // true
o3 instanceof C; // true, C.prototype موجودة في سلسلة الكائن o3

</syntaxhighlight>لاحظ أنَّ قيمة الاختبار <code>instanceof</code> قد تختلف اعتمادًا على خاصية <code>prototype</code> للدوال البانية، ويمكن تغييرها بتغيير سلسلة prototype للكائن عبر الدالة <code>[[JavaScript/Object/setPrototypeOf|Object.setPrototypeOf()‎]]</code>.

== أمثلة ==

=== الكائنان <code>[[JavaScript/String|String]]</code> و <code>[[JavaScript/Date|Date]]</code> نوعهما هو <code>[[JavaScript/Object|Object]]</code> ===
الشيفرة الآتية تستخدم المعامل <code>instanceof</code> لتوضيح أنَّ الكائنين <code>[[JavaScript/String|String]]</code> و <code>[[JavaScript/Date|Date]]</code> مشتقان من الكائن <code>[[JavaScript/Object|Object]]</code>.

لكن الكائنات المُنشَأة بالشكل المختصر هي استثناءٌ هنا، لأنَّ سلسلة prototype لها غير مُعرَّفة، لكنه التعبير <code>instanceof Object</code> سيعيد <code>true</code>.<syntaxhighlight lang="javascript">
var simpleStr = 'This is a simple string'; 
var myString  = new String();
var newStr    = new String('String created with constructor');
var myDate    = new Date();
var myObj     = {};

simpleStr instanceof String; // false, لأن سلسلة prototype قيمتها هي undefined
myString  instanceof String; // true
newStr    instanceof String; // true
myString  instanceof Object; // true

myObj instanceof Object;    // true, على الرغم من أنَّ قيمة الخاصية prototype هو undefined
({})  instanceof Object;    // true, كما في الحالة السابقة

myString instanceof Date;   // false

myDate instanceof Date;     // true
myDate instanceof Object;   // true
myDate instanceof String;   // false

</syntaxhighlight>

=== استخدام المعامل <code>instanceof</code> على كائن خاص ===
سنُنشِئ في المثال الآتي كائنًا نوعه هو <code>Car</code> وسنُنشِئ نسخةً منه باسم <code>mycar</code>، وسيوضِّح المعامل <code>instanceof</code> أنَّ الكائن <code>mycar</code> من النوع <code>Car</code> و <code>Object</code>:<syntaxhighlight lang="javascript">
function Car(make, model, year) {
  this.make = make;
  this.model = model;
  this.year = year;
}
var mycar = new Car('Honda', 'Accord', 1998);
var a = mycar instanceof Car;    // true
var b = mycar instanceof Object; // true

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-relational-operators ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-relational-operators ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-11.8.6 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf#sec-11.8.6 ECMAScript 3rd Edition]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Operator|{{SUBPAGENAME}}]]