عرض مصدر JavaScript/Function

<noinclude>{{DISPLAYTITLE:الكائن <code>Function</code> في JavaScript}}</noinclude>
الدالة البانية <code>Function</code> تُنشِئ كائن <code>Function</code> جديد، واستدعاء الدالة البانية مباشرةً يمكِّننا من إنشاء الدوال ديناميكيًا، لكنه يعاني من مشاكل تتعلق بالأداة والناحية الأمنية بما يشابه دالة <code>[[JavaScript/eval|eval]]</code>.

يجدر بالذكر أنَّ جميع الدوال في JavaScript هي كائنات <code>Function</code>.
==البنية العامة==
<syntaxhighlight lang="javascript">
new Function ([arg1[, arg2[, ...argN]],] functionBody)

</syntaxhighlight>

=== <code>arg1, arg2, ... arg''N''</code> ===
الأسماء المستخدمة من الدالة للإشارة إلى الوسائط المُمرَّرة إلى الدالة، ويجب أن تكون سلاسل نصية تُمثِّل مُعرِّفات JavaScript صالحة أو قائمة من تلك السلاسل النصية التي يُفصَل بينها بفاصلة؛ مثلًا: <code>"x"</code> أو <code>"theValue"</code> أو <code>"a,b"</code>.

=== <code>functionBody</code> ===
سلسلة نصية تحتوي على تعابير JavaScript التي تُشكِّل جسم الدالة.

== الوصف ==
كائنات <code>Function</code> التي تُنشَأ عبر الدالة البانية <code>Function</code> ستُفسَّر عند إنشاء الدالة. وهي أقل كفاءةً من تعابير [[JavaScript/function|التصريح عن الدوال]] أو [[JavaScript/Function Expression|تعابير تعريف الدوال]]. 

جميع الوسائط المُمرَّرة إلى الدالة ستُعامل كأسماء لمُعرِّفات المعاملات التي أُنشِئَت في الدالة، وبالترتيب الذي مُرِّرَت فيه. 

استدعاء الدالة البانية <code>Function</code> كدالة عادية (أي دون استخدام المعامل <code>[[JavaScript/new|new]]</code>) لها نفس أثر استدعائها كدالة بانية. 

== الخاصيات والدوال التابعة للدالة البانية <code>Function</code> ==
الكائن العام <code>Function</code> لا يملك خاصيات أو دوال تابعة له، لكن لمّا كان دالةً، فسيرث بعض الدوال والخاصيات عبر سلسلة prototype من <code>[[JavaScript/Function/prototype|Function.prototype]]</code>.

== الكائن prototype ==

=== الخاصيات ===

==== <code>[[JavaScript/Function/arguments|Function.arguments]]</code> ====
مصفوفة تحتوي على الوسائط المُمرَّرة إلى الدالة، وهذه الخاصية أصبحت مهملة (deprecated)، ويُفضَّل استخدام الكائن <code>[[JavaScript/arguments|arguments]]</code> المتاح ضمن الدوال بدلًا منها.

==== <code>Function.arity</code> ====
تحديد عدد الوسائط التي تتوقعها الدالة. هذه الدالة محذوفة وغير مدعومة في جميع المتصفحات، ويجب استخدام الخاصية <code>[[JavaScript/Function/length|length]]</code> بدلًا منها.

==== <code>[[JavaScript/Function/caller|Function.caller]]</code> ====
تحديد اسم الدالة التي استدعت الدالة التي تُنفَّذ حاليًا.

==== <code>[[JavaScript/Function/length|Function.length]]</code> ====
تحديد عدد الوسائط الذي تتوقعه الدالة.

==== <code>[[JavaScript/Function/name|Function.name]]</code> ====
إعادة اسم الدالة.

==== <code>Function.displayName</code> ====
إعادة اسم العرض (display name) للدالة. هذه الخاصية غير معيارية، وغير مدعومة في جميع المتصفحات.

==== <code>Function.prototype.constructor</code> ====
تُحديد الدالة التي ستُنشِئ كائن prototype للدالة؛ راجع صفحة الخاصية <code>[[JavaScript/Object/constructor|Object.prototype.constructor]]</code> لمزيدٍ من التفاصيل.

=== الدوال ===

==== <code>[[JavaScript/Function/apply|Function.prototype.apply()‎]]</code> ====
استدعاء دالة وضبط قيمة المعامل <code>[[JavaScript/this|this]]</code> فيها إلى القيمة المعطية، وستُمرَّر الوسائط إليها كمصفوفة <code>[[JavaScript/Array|Array]]</code>.

==== <code>[[JavaScript/Function/bind|Function.prototype.bind()‎]]</code> ====
إنشاء دالة جديدة التي ستُضبَط قيمة المعامل <code>[[JavaScript/this|this]]</code> عند استدعائها إلى القيمة المُحدَّدة، إضافةً إلى سلسلة الوسائط المُحدَّدة.

==== <code>[[JavaScript/Function/call|Function.prototype.call()‎]]</code> ====
استدعاء دالة وضبط قيمة المعامل <code>[[JavaScript/this|this]]</code> فيها إلى القيمة المعطية، وستُمرَّر الوسائط إليها كما هي.

==== <code>Function.prototype.isGenerator()‎</code> ====
إعادة القيمة <code>true</code> إذا كان الدالة [[JavaScript/function*|دالةً مولِّدةً]] (generator)؛ وإلا فستعيد القيمة <code>false</code>. هذه الدالة غير معيارية وغير مدعومة في جميع المتصفحات.

==== <code>Function.prototype.toSource()‎</code> ====
إعادة سلسلة نصية تحتوي على الشيفرة المصدرية التي تُمثِّل هذه الدالة. هذه الخاصية محذوفة وغير مدعومة في أغلبية المتصفحات.

==== <code>[[JavaScript/Function/toString|Function.prototype.toString()‎]]</code> ====
إعادة سلسلة نصية تُمثِّل الدالة، وهي إعادة تعريف للدالة <code>[[JavaScript/Object/toString|Object.prototype.toString]]</code>.

== النسخ المُنشَأة من <code>Function</code> ==
النسخ المُنشَأة من الدالة البانية <code>Function</code> ترث الدوال والخاصيات من كائن <code>[[JavaScript/Function/prototype|Function.prototype]]</code>؛ وكما في جميع الدوال البانية، يمكنك إجراء تغييرات إلى كائن <code>prototype</code> في الدالة البانية لكي تنعكس تلك التعديلات إلى جميع نسخ الكائن <code>Function</code>.

== أمثلة ==

=== تعريف معاملات مع الدالة البانية <code>Function</code> ===
الشيفرة الآتية تُنشِئ دالةً باستخدام الدالة البانية <code>Function</code> تقبل وسيطين:<syntaxhighlight lang="javascript">
var adder = new Function('a', 'b', 'return a + b');

adder(2, 6); // 8

</syntaxhighlight>ستُستخدَم قيمة الوسيطين <code>a</code> و <code>b</code> في جسم الدالة في التعبير <code>return a + b</code>.

=== الفرق بين الدوال المنشَأة عبر الدالة البانية وتعابير التصريح عن الدوال ===
الدوال المُنشَأة عبر الدالة البانية <code>Function</code> لا تُنشئ تعابير مغلقة (closures) في سياق إنشائها، فهي تُنشَأ دومًا في المجال العام (global scope)، فعندي تشغيلها ستتمكن من الوصول إلى قيم المتغيرات المحلية الخاصة بها والمتغيرات العامة، وليس المتغيرات الموجودة في سياق استدعاء الدالة المُنشَأة من الدالة البانية <code>Function</code>. وهذا يختلف عن استخدام الدالة <code>[[JavaScript/eval|eval]]</code> مع شيفرة تحتوي على تعبيرٍ لتعريف دالة.<syntaxhighlight lang="javascript">
var x = 10;

function createFunction1() {
    var x = 20;
    return new Function('return x;'); // المتغير العام
}

function createFunction2() {
    var x = 20;
    function f() {
        return x; // المتغير المحلي
    }
    return f;
}

var f1 = createFunction1();
console.log(f1());          // 10
var f2 = createFunction2();
console.log(f2());          // 20

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
انظر إلى صفحة كل دالة من الدوال التابعة للكائن <code>Function</code> لتفاصيل عن دعم المتصفحات لها.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-function-objects ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-function-objects ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.3 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Function|{{SUBPAGENAME}}]]
__NOEDITSECTION__