عرض مصدر JavaScript/Function Expression

<noinclude>{{DISPLAYTITLE:تعبير تعريف الدوال}}</noinclude>
الكلمة المحجوزة <code>function</code> تُستخدَم لتعريف دالة داخل تعبير (expression). يمكنك أيضًا تعريف الدوال عبر التصريح عنها <code>[[JavaScript/function|function declaration]]</code> أو عبر الدالة البانية <code>[[JavaScript/Function|Function]]</code>.
==البنية العامة==
<syntaxhighlight lang="javascript">
var myFunction = function [name]([param1[, param2[, ..., paramN]]]) {
   statements
};

</syntaxhighlight>
=== <code>name</code> ===
اسم الدالة، ويمكن حذفه وحينئذٍ ستسمى الدالة بالدالة المجهولة؛ واسم الدالة لن يكون متاحًا إلا داخل الدالة نفسها (يمكن أن يستعمل لتنفيذها تعاوديًا [recursively]).

=== <code>param</code> ===
اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي يُفسِّر اللغة.

=== <code>statements</code> ===
التعابير البرمجية التي تُشكِّل جسم الدالة.

== الوصف ==
تعابير تعريف الدوال تشبه كثيرًا (وتكاد تماثل) طريقة التصريح عن الدالة (<code>[[JavaScript/function|function declaration]]</code>)، والفرق الرئيسي بينهما هو اسم الدالة، الذي يمكن حذفه في تعابير تعريف الدوال لإنشاء دوال مجهولة (anonymous function)؛ ويمكن أن استدعاء تعبير تعريف الدالة مباشرةً (ويسمى ذلك Immediately Invoked Function Expression اختصارًا IIFE) مما يؤدي إلى تنفيذ الدالة بعد تعريفها مباشرةً.

=== استدعاء الدالة قبل تعريفها ===
لا يمكن استدعاء الدوال المُعرَّفة عبر تعابير تعريف الدوال (function expressions) في JavaScript قبل تعريفها، وذلك على النقيض من الدوال المُصرَّح عنها ([[JavaScript/function|function declarations]]):<syntaxhighlight lang="javascript">
notHoisted(); // TypeError: notHoisted is not a function

var notHoisted = function() {
   console.log('bar');
};
</syntaxhighlight>

=== تعابير تعريف الدالة مع تحديد اسم لها ===
إذا أردتَ الإشارة إلى الدالة الحالية داخل جسم الدالة، فعليك إنشاء تعبير تعريف للدالة مع اسم، وهذا الاسم محليٌ وخاصٌ بالدالة ولا يمكن استخدامه خارج مجالها، لكن الغرض منه هو تجنب استخدام الخاصية <code>[[JavaScript/arguments/callee|arguments.callee]]</code>:<syntaxhighlight lang="javascript">
var math = {
  'factorial': function factorial(n) {
    if (n <= 1)
      return 1;
    return n * factorial(n - 1);
  }
};

</syntaxhighlight>المتغير الذي سيُسنَد إلى الدالة سيكون له خاصية (property) باسم <code>name</code>، ولن يتغيّر الاسم لو أُعيد إسناده إلى متغيرٍ آخر، وإذا حُذِفَ اسم الدالة فستكون قيمة تلك الخاصية مساويةً لاسم المتغير، وسينطبق المثل على [[JavaScript/Arrow Functions|الدوال السهمية]] (التي لا تملك اسمًا خاصًا بها، لذا ستُعطى اسم المتغير الذي أُسنِدَت إليه):<syntaxhighlight lang="javascript">
var foo = function() {}
foo.name // "foo"

var foo2 = foo
foo2.name // "foo"

var bar = function baz() {}
bar.name // "baz"

</syntaxhighlight>

== أمثلة ==
يعُرِّف المثال الآتي دالةً مجهولةً ويُسنِدُها إلى المتغير <code>x</code>، لاحظ أنَّ الدالة ستُعيد مربّع الوسيط المُمرَّر إليها:<syntaxhighlight lang="javascript">
var x = function(y) {
   return y * y;
};

</syntaxhighlight>ومن الشائع استخدام الدوال المجهولة في معالجة الأحداث:<syntaxhighlight lang="javascript">
button.addEventListener('click', function(event) {
    console.log('button is clicked!')
})
</syntaxhighlight>

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

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-function-definitions ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-function-definitions ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-13 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf#sec-13 ECMAScript 3rd Edition]. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Operator]]
[[تصنيف:JavaScript Functions]]