Object.prototype.__defineGetter__()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

الدالة Object.prototype.__defineGetter__()‎‎ تربط دالةً بإحدى خاصيات الكائن، وستستدعى تلك الدالة عند محاولة الوصول إلى الخاصية.

تحذير: هذه الدالة مهملة ويُفتَرَض تعريف دوال getter عند تهيئة الكائنات أو باستخدام الدالة Object.defineProperty()‎، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في آخر مسودة من معيار ECMAScript لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها.

البنية العامة

obj.__defineGetter__(prop, func)

prop

سلسلة نصية تحتوي على اسم الخاصية التي نريد ربط الدالة المعطية إليها.

func

الدالة التي نريد استدعاءها عند محاولة الوصول إلى الخاصية المعنية.

القيمة المعادة

القيمة undefined.

الوصف

تسمح الدالة __defineGetter__ بتعريف دالة getter على كائنٍ موجودٍ مسبقًا.

أمثلة

مثال عن استخدام الدالة __defineGetter__، نُذكِّر أنَّه لا يجدر بنا استخدام هذه الطريقة:
var o = {};
o.__defineGetter__('gimmeFive', function() { return 5; });
console.log(o.gimmeFive); // 5
يمكننا تنفيذ ما سبق بطريقةٍ معيارية عبر تعريف دالة getter باستخدام الشكل المختصر لتهيئة الكائنات:
var o = { get gimmeFive() { return 5; } };
console.log(o.gimmeFive); // 5
أو باستخدام الدالة Object.defineProperty()‎:
var o = {};
Object.defineProperty(o, 'gimmeFive', {
  get: function() {
    return 5;
  }
});
console.log(o.gimmeFive); // 5

دعم المتصفحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم نعم 11 نعم نعم

مصادر ومواصفات