عرض مصدر JavaScript/undefined

<noinclude>{{DISPLAYTITLE:<code>undefined</code>في JavaScript}}</noinclude>
الخاصية العامة <code>undefined</code> تُمثِّل القيمة الأوليّة <code>undefined</code> في JavaScript.
{| class="wikitable"
! colspan="2" |سمات الخاصية undefined
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|لا
|}

==البنية العامة==
<syntaxhighlight lang="javascript">
undefined
</syntaxhighlight>
== الوصف ==
الخاصية <code>undefined</code> هي خاصيةٌ للكائن العام (global object) أي أنها متغيرٌ في المجال العام، والقيمة الابتدائية للخاصية <code>undefined</code> هي نوع البيانات الأوليّ <code>undefined</code>.

الخاصية <code>undefined</code> غير قابلة للضبط وغير قابلة للكتابة في المتصفحات الحديثة (بدءًا من معيار ECMAScript 5)، لكن مع ذلك حاول تجنّب الكتابة عليها.

المتغيرات التي لم تُسنَد لها قيمةٌ سيكون نوعها هو <code>undefined</code>، والتعابير البرمجية ستُعيد <code>undefined</code> إذا لم تُسنَد قيمةٌ إلى المتغير الذي يُقدِّر قيمتها، وستُعيد دالةٌ ما القيمة <code>undefined</code> إذا لم نُحدِّد قيمةً لتعيدها تلك الدالة عبر التعبير البرمجي <code>[[JavaScript/return|return]]</code>.

وصحيحٌ أنَّ بإمكاننا استخدام الكلمة <code>undefined</code> كمُعرِّف (identifier، أي اسم لأحد المتغيرات) في أي مجال عدا المجال العام (وذلك لأنَّ <code>undefined</code> ليست كلمةً محجوزةً)، لكن من غير المناسب فعل ذلك، وسيؤدي ذلك إلى تصعيب صيانة وتنقيح أخطاء البرنامج.<syntaxhighlight lang="javascript">
// لا تفعل هذا أبدًا

// "foo string"
(function() { var undefined = 'foo'; console.log(undefined, typeof undefined); })();

// "foo string"
(function(undefined) { console.log(undefined, typeof undefined); })('foo');

</syntaxhighlight>

== أمثلة ==

=== معامل المطابقة مع <code>undefined</code> ===
يمكنك استخدام معامل المطابقة (<code>===</code>) مع <code>undefined</code> لمعرفة إذا امتلك متغيرٌ ما قيمةً، ففي الشيفرة الآتية لم تُعرَّف قيمةٌ للمتغير <code>x</code>، وستكون نتيجة التعبير البرمجي <code>[[JavaScript/if...else|if]]</code> هي <code>true</code>:<syntaxhighlight lang="javascript">
var x;
if (x === undefined) {
   // ستُنفَّذ التعابير البرمجية هنا
}
else {
   // لن تُنفَّذ التعابير البرمجية هنا
}
</syntaxhighlight>لاحظ أنَّنا استخدمنا معامل المطابقة (<code>===</code>) بدلًا من استخدام معامل المساواة العادي (<code>==</code>)، وذلك لأنَّ <code>x == undefined</code> سيُعيد القيمة <code>true</code> إذا كانت قيمة <code>x</code> تساوي <code>[[JavaScript/null|null]]</code>، بينما لا يفعل ذلك معامل المطابقة؛ فالقيمة <code>[[JavaScript/null|null]]</code> لا تكافئ <code>undefined</code>. راجع صفحة [[JavaScript/Comparison Operators|معاملات المقارنة]] للتفاصيل.

=== المعامل <code>[[JavaScript/typeof|typeof]]</code> والقيمة <code>undefined</code> ===
بشكلٍ بديلٍ عمّا سبق، يمكننا استخدام المعامل <code>[[JavaScript/typeof|typeof]]</code> لمعرفة إذا كانت قيمة المتغير <code>undefined</code>:<syntaxhighlight lang="javascript">
var x;
if (typeof x === 'undefined') {
   // ستُنفِّذ التعابير البرمجية هنا
}
</syntaxhighlight>أحد أسباب استخدام المعامل <code>[[JavaScript/typeof|typeof]]</code> هو أنَّه لن يؤدي إلى رمي خطأ عند عدم التصريح عن المتغير:<syntaxhighlight lang="javascript">
// لم يُعرَّف المتغير بعد
if (typeof x === 'undefined') { // دون مشاكل
   // ستُنفَّذ التعابير البرمجية هنا
}

if (x === undefined) { // يرمي ReferenceError

}

</syntaxhighlight>

=== المعامل <code>[[JavaScript/void|void]]</code> والقيمة <code>undefined</code> ===
طريقة ثالثة للتحقق إذا كانت قيمة أحد المتغيرات تساوي <code>undefined</code> هي استخدام المعامل <code>[[JavaScript/void|void]]</code>:<syntaxhighlight lang="javascript">
var x;
if (x === void 0) {
   // ستُنفَّذ التعابير البرمجية هنا
}

// لم يُعرَّف هذا المتغير من قبل
if (y === void 0) {
   // سيرمى الخطأ a - Uncaught ReferenceError: y is not defined
}

</syntaxhighlight>

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

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