عرض مصدر JavaScript/typeof

<noinclude>{{DISPLAYTITLE:المعامل <code>typeof</code> في JavaScript}}</noinclude>
المعامل <code>typeof</code> يُعيد سلسلةً نصية تُشير إلى نوع القيمة التي تليه.
==البنية العامة==
<syntaxhighlight lang="javascript">
typeof operand

</syntaxhighlight>

=== <code>operand</code> ===
تعبير يُمثِّل كائنًا أو نوع بيانات أوليّ الذي نريد إعادة نوعه.

== الوصف ==
الجدول الآتي يُلخِّص القيم التي يمكن أن يُعيدها المعامل <code>typeof</code>:
{| class="wikitable"
!النوع
!النتيجة
|-
|<code>[[JavaScript/undefined|undefined]]</code>
|<code>"undefined"</code>
|-
|<code>[[JavaScript/null|null]]</code>
|<code>"object"</code> (انظر الأمثلة)
|-
|<code>[[JavaScript/Boolean|Boolean]]</code>
|<code>"boolean"</code>
|-
|<code>[[JavaScript/Number|Number]]</code>
|<code>"number"</code>
|-
|<code>[[JavaScript/String|String]]</code>
|<code>"string"</code>
|-
|<code>[[JavaScript/Symbol|Symbol]]</code> (جديد في ECMAScript 2015)
|<code>"symbol"</code>
|-
|<code>[[JavaScript/Function|Function]]</code>
|<code>"function"</code>
|-
|أي كائن آخر
|<code>"object"</code>
|}

== أمثلة ==
<syntaxhighlight lang="javascript">
// الأعداد
typeof 37 === 'number';
typeof 3.14 === 'number';
typeof(42) === 'number';
typeof Math.LN2 === 'number';
typeof Infinity === 'number';
typeof NaN === 'number'; // على الرغم أنَّه "Not-A-Number"
typeof Number(1) === 'number'; // لا تستخدم هذه الصيغة


// السلاسل النصية
typeof '' === 'string';
typeof 'bla' === 'string';
typeof '1' === 'string'; // الأعداد الموجودة داخل السلاسل النصية هي سلاسل نصية
typeof (typeof 1) === 'string'; // نوع typeof هو سلسلة نصية
typeof String('abc') === 'string'; // لا تستخدم هذه الصيغة


// القيم المنطقية
typeof true === 'boolean';
typeof false === 'boolean';
typeof Boolean(true) === 'boolean'; // لا تستخدم هذه الصيغة


// الرموز
typeof Symbol() === 'symbol'
typeof Symbol('foo') === 'symbol'
typeof Symbol.iterator === 'symbol'


// Undefined
typeof undefined === 'undefined';
typeof declaredButUndefinedVariable === 'undefined';
typeof undeclaredVariable === 'undefined'; 


// الكائنات
typeof {a: 1} === 'object';

// use Array.isArray or Object.prototype.toString.call
// to differentiate regular objects from arrays
typeof [1, 2, 4] === 'object';

typeof new Date() === 'object';


// لا تستخدم الأشكال الآتية
typeof new Boolean(true) === 'object'; 
typeof new Number(1) === 'object'; 
typeof new String('abc') === 'object';


// الدوال
typeof function() {} === 'function';
typeof class C {} === 'function';
typeof Math.sin === 'function';
</syntaxhighlight>

=== القيمة <code>null</code> ===
<syntaxhighlight lang="javascript">
typeof null === 'object';

</syntaxhighlight>في أوّل تطبيق للغة JavaScript، كانت القيم في JavaScript تُمثَّل بالنوع والقيمة، وكان نوع الكائنات مرتبطًا بالرقم <code>0</code>، وكانت تُمثَّل القيمة <code>null</code> كمؤشِّر NULL (الذي قيمته هي <code>0x00</code> في أغلبية المنصات)، وبالتالي كان للقيمة <code>null</code> النوع <code>0</code>، والنوع <code>0</code> يُمثِّل الكائنات، لهذا السبب كانت نتيجة <code>typeof</code> للقيمة <code>null</code> هي <code>object</code> ([http://www.2ality.com/2013/10/typeof-null.html المصدر]).

أُقتِرَح حلٌّ للمشكلة لمعيار ECMAScript، لكنه رُفِضَ، وكان سيُنتِج <code>typeof null === 'null'‎</code>.

=== استخدام المعامل <code>[[JavaScript/new|new]]</code> ===
جميع الدوال البانية التي تُهيّئ باستخدام الكلمة المحجوزة <code>[[JavaScript/new|new]]</code> سيكون لها النوع <code>object</code>:<syntaxhighlight lang="javascript">
var str = new String('String');
var num = new Number(100);

typeof str; // 'object'
typeof num; // 'object'
</syntaxhighlight>باستثناء الدالة البانية <code>[[JavaScript/Function|Function]]</code> المُضمَّنة في JavaScript:<syntaxhighlight lang="javascript">
var func = new Function();

typeof func; // 'function'

</syntaxhighlight>

=== المناطق الميتة زمنيًا ===
قبل ECMAScript 2015، كان من المضمون أن يُعيد المعامل <code>typeof</code> سلسلةً نصيةً لأي تعبير يُمرَّر إليه، لكن مع إضافة المتغيرات ذات المجال الكتلي والتي لا يمكن استخدامها قبل التصريح عنها: <code>[[JavaScript/let|let]]</code> و <code>[[JavaScript/const|const]]</code>، فإنَّ استخدام المعامل <code>typeof</code> على متغيرات <code>[[JavaScript/let|let]]</code> و <code>[[JavaScript/const|const]]</code> قبل التصريح عنها سيؤدي إلى رمي الخطأ <code>[[JavaScript/ReferenceError|ReferenceError]]</code>؛ وهذا يختلف عن المتغيرات غير المُصرَّح عنها عبر <code>[[JavaScript/var|var]]</code>. تذكَّر أنَّ المتغيرات ذات المجال الكتلي تكون في «<nowiki/>[[JavaScript/let|منطقة ميتة زمنيًا]]» (temporal dead zone) من بداية الكتلة التي ستُعرَّف فيها إلى حين تعريفها، وسيُرمى خطأٌ إن حاولنا الوصول إليها:<syntaxhighlight lang="javascript">
typeof undeclaredVariable === 'undefined'; // true
typeof newLetVariable; let newLetVariable; // ReferenceError
typeof newConstVariable; const newConstVariable = 'hello'; // ReferenceError

</syntaxhighlight>

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

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