عرض مصدر JavaScript/Function/caller

<noinclude>{{DISPLAYTITLE:<code>Function.caller</code>}}</noinclude>
الخاصية <code>Function.caller</code> تُعيد الدالة التي استدعت الدالة التي تُنفَّذ حاليًا. لا يجوز استخدام هذه الخاصية في [[JavaScript/Strict Mode|نمط strict]].

== الوصف ==
إذا لم تُستدعَ الدالة <code>f</code> ضمن دالة أخرى (أي أنها استدعيت في أعلى مستوى top level)، فقيمة الخاصية <code>f.caller</code> هي <code>[[JavaScript/null|null]]</code>. 

هذه الخاصيةُ هي بديلٌ عن الخاصية المحذوفة <code>arguments.caller</code> التابعة للكائن <code>[[JavaScript/arguments|arguments]]</code>.
لاحظ أنَّه في حالة الاستدعاء التعاودي (recursion)، فلا يمكننا إعادة بناء مكدس الاستدعاءات (call stack) باستخدام هذه الخاصية. فلتكن لدينا الشيفرة:<syntaxhighlight lang="javascript">
function f(n) { g(n - 1); }
function g(n) { if (n > 0) { f(n); } else { stop(); } }
f(2);

</syntaxhighlight>وفي لحظة استدعاء الدالة <code>stop()</code>‎ سيكون مكدس الاستدعاءات بالشكل الآتي:<syntaxhighlight lang="javascript">
f(2) -> g(1) -> f(1) -> g(0) -> stop()

</syntaxhighlight>ويكون التعبير الآتي صحيحًا:<syntaxhighlight lang="javascript">
stop.caller === g && f.caller === g && g.caller === f

</syntaxhighlight>إذا حاولنا الحصول على مكدس الاستدعاءات في الدالة <code>stop()</code>‎ كما يلي:<syntaxhighlight lang="javascript">
var f = stop;
var stack = 'Stack trace:';
while (f) {
  stack += '\n' + f.name;
  f = f.caller;
}

</syntaxhighlight>فلن تنتهي حلقة التكرار أبدًا.
== أمثلة ==
مثال بسيط يختبر الخاصية <code>caller</code> التابعة للدالة لمعرفة إن كانت مستدعاةً ضمن دالة أخرى أم لا:<syntaxhighlight lang="javascript">
function myFunc() {
  if (myFunc.caller == null) {
    return 'The function was called from the top!';
  } else {
    return 'This function\'s caller was ' + myFunc.caller;
  }
}
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|8
|نعم
|نعم
|}
== مصادر ومواصفات ==
هذه الخاصية غير معيارية، وهي مُطبَّقة في إصدار JavaScript 1.5.
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Function|{{SUBPAGENAME}}]]