عرض مصدر JavaScript/Object/defineSetter

<noinclude>{{DISPLAYTITLE:<code>Object.prototype.__defineSetter__()‎</code>}}</noinclude>
الدالة <code>Object.prototype.__defineSetter__()‎‎</code> تربط دالةً بإحدى خاصيات الكائن، وستستدعى تلك الدالة عند محاولة ضبط قيمة تلك الخاصية.

تحذير: هذه الدالة مهملة ويُفتَرَض تعريف دوال [[JavaScript/set|setter]] عند [[JavaScript/Object Initializer|تهيئة الكائنات]] أو باستخدام الدالة <code>[[JavaScript/Object/defineProperty|Object.defineProperty()‎]]</code>، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في [https://tc39.github.io/ecma262/#sec-additional-ecmascript-features-for-web-browsers آخر مسودة من معيار ECMAScript] لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها.

== البنية العامة ==
<syntaxhighlight lang="javascript">
obj.__defineSetter__(prop, fun)

</syntaxhighlight>

=== <code>prop</code> ===
سلسلة نصية تحتوي على اسم الخاصية التي نريد ربط الدالة المعطية إليها.

=== <code>fun</code> ===
الدالة التي نريد استدعاءها عند محاولة ضبط قيمة الخاصية المعنية. وتأخذ هذه الدالة الشكل الآتي:<syntaxhighlight lang="javascript">
function(val) { . . . }

</syntaxhighlight>إذ إنَّ الوسيط <code>val</code> سيحمل القيمة التي حاولنا إسنادها إلى الخاصية <code>prop</code>.

=== القيمة المعادة ===
القيمة <code>[[JavaScript/undefined|undefined]]</code>.

== الوصف ==
تسمح الدالة <code>__defineSetter__</code> بتعريف دالة [[JavaScript/set|setter]] على كائنٍ موجودٍ مسبقًا.

== أمثلة ==
مثال عن استخدام الدالة <code>__defineSetter__</code>، نُذكِّر أنَّه لا يجدر بنا استخدام هذه الطريقة:<syntaxhighlight lang="javascript">
var o = {};
o.__defineSetter__('value', function(val) { this.anotherValue = val; });
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

</syntaxhighlight>يمكننا تنفيذ ما سبق بطريقةٍ معيارية عبر تعريف دالة [[JavaScript/set|setter]] باستخدام [[JavaScript/Object Initializer|الشكل المختصر لتهيئة الكائنات]]:<syntaxhighlight lang="javascript">
var o = { set value(val) { this.anotherValue = val; } };
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

</syntaxhighlight>أو باستخدام الدالة <code>[[JavaScript/Object/defineProperty|Object.defineProperty()‎]]</code>:

<syntaxhighlight lang="javascript">
var o = {};
Object.defineProperty(o, 'value', {
  set: function(val) {
    this.anotherValue = val;
  }
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|11
|نعم
|نعم
|}
== مصادر ومواصفات ==
*مسودة المعيار [https://tc39.github.io/ecma262/#sec-object.prototype.__defineSetter__ ECMAScript Latest Draft]. جعلتها هذه المسودة معياريةً.
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Object|{{SUBPAGENAME}}]]