عرض مصدر JavaScript/Property Accessors

<noinclude>{{DISPLAYTITLE:الوصول إلى الخاصيات في JavaScript}}</noinclude>
طرائق الوصول إلى الخاصيات توفِّر وصولًا إلى خاصيات أحد الكائنات باستخدام طريقة النقط أو طريقة الأقواس. 
==البنية العامة==
<syntaxhighlight lang="javascript">
object.property
object['property']
</syntaxhighlight>
== الوصف ==
يمكننا عدّ الكائنات على أنها مصفوفات ترابطية (أي associative array، ويُطلَق عليها أيضًا map و dictionary و hash و lookup table)، وتكون المفاتيح (keys) في المصفوفة هي أسماء خاصيات الكائن.

من الشائع عند حديثنا عن خاصيات الكائنات التفريق بين الخاصيات (properties) والدوال التابعة للكائن، لكن تقنيًا تكون الدوال هي خاصيات مُنشَأة من الكائن <code>[[JavaScript/Function|Function]]</code>.

هنالك طريقتان للوصول إلى خاصيات الكائنات: طريقة النقط وطريقة الأقواس.

=== طريقة النقط ===
<syntaxhighlight lang="javascript">
get = object.property;
object.property = set;
</syntaxhighlight>يجب أن يكون اسم الخاصية <code>property</code> مُعرِّفًا صالحًا في JavaScript، أي يجب أن يكون سلسلةً من المحارف النصية والأرقام، ويمكن تضمين شرطة سفلية فيه <code>_</code> أو إشارة الدولار <code>$</code>، لكن لا يجوز أن يبدأ برقم، فمثلًا يجوز استخدام المُعرِّف <code>object.$1</code> لكن '''لا''' يجوز استخدام <code>object.1</code>.<syntaxhighlight lang="javascript">
document.createElement('pre');

</syntaxhighlight>سنصل في الشيفرة السابقة إلى الدالة <code>createElement</code>، التي هي خاصيةٌ من خاصيات الكائن <code>document</code>.

إذا أردتَ استخدام دالة على قيمة رقمية أوليّة ولم يكن لها فاصلة عشرية، فاترك فراغًا (أو فراغات) قبل النقطة التي تسبق الدالة لمنع تفسيرها كفاصلة عشرية، أو ضع نقطتين وراء بعضهما، أو ضع [[JavaScript/Grouping|معامل التجميع]]:<syntaxhighlight lang="javascript">
77 .toExponential();
// أو
77
.toExponential();
// أو
(77).toExponential();
// أو
77..toExponential();
// أو
77.0.toExponential();
// لأن 77. === 77.0
</syntaxhighlight>

=== طريقة الأقواس ===
<syntaxhighlight lang="javascript">
get = object[property_name];
object[property_name] = set;
</syntaxhighlight>اسم الخاصية <code>property_name</code> هو سلسلة نصية، وليس ضروريًا أن تكون السلسلةُ النصيةُ معُرِّفًا صالحًا في JavaScript، وإنما يمكن أن تكون أيّة قيمة مثل <code>"1foo"</code> و <code>"!bar!"</code> وحتى <code>" "</code> (فراغ).<syntaxhighlight lang="javascript">
document['createElement']('pre');

</syntaxhighlight>الشيفرة السابقة لها نفس تأثير الشيفرة المذكورة في القسم السابق.

يُسمَح أيضًا بوجود فراغ بين القوس واسم الكائن كما في الشيفرة الآتية:<syntaxhighlight lang="javascript">
document ['createElement']('pre');

</syntaxhighlight>

=== أسماء الخاصيات ===
يجب أن تكون أسماء الخاصيات سلاسلَ نصيةً، وهذا يعني أنَّه لا يُسمَح باستخدام كائنات ليست سلاسل نصية كمفاتيح لخاصيات الكائن، وأيّة كائنات غير نصية -بما في ذلك الأرقام- ستحوّل إلى سلسلة نصية باستخدام الدالة <code>[[JavaScript/Object/toString|toString()]]</code>‎:<syntaxhighlight lang="javascript">
var object = {};
object['1'] = 'value';
console.log(object[1]);
</syntaxhighlight>ناتج المثال السابق هو <code>value</code> لأنَّ القيمة الرقمية 1 قد حُوِّلَت إلى '1'.

=== ملاحظة عن استخدام <code>[[JavaScript/eval|eval]]</code> ===
قد يستخدم البعض الدالة <code>[[JavaScript/eval|eval]]</code> في الحالات التي يمكن استخدام طريقة الأقواس فيها، فالشكل الآتي نراه في سكربتات كثيرة:<syntaxhighlight lang="javascript">
x = eval('document.forms.form_name.elements.' + strFormControl + '.value');

</syntaxhighlight>الدالة <code>[[Javascript/eval|eval]]</code> دالةٌ بطيئةٌ ويجب تفادي استخدامها عند القدرة على ذلك؛ لاحظ أيضًا أنَّ قيمة <code>strFormControl</code> يجب أن تكون مُعرِّفًا صالحًا في JavaScript، وقت تكون أسماء أو مُعرِّفات حقول النموذج غير صالحة كمُعرِّفات في JavaScript، لذا من الأفضل استخدام طريقة الأقواس في هذه الحالة:<syntaxhighlight lang="javascript">
x = document.forms['form_name'].elements[strFormControl].value;

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
*مسودة المعيار [https://tc39.github.io/ecma262/#sec-property-accessors ECMAScript Latest Draft].
*معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-property-accessors ECMAScript 2015 (6th Edition)]‎.
*معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-11.2.1 ECMAScript 5.1].
*معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf#sec-11.2.1 ECMAScript 1st Edition] .
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Operator|{{SUBPAGENAME}}]]