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

<noinclude>{{DISPLAYTITLE:<code>Function.length</code>}}</noinclude>
الخاصية <code>Function.length</code> تُحدِّد عدد الوسائط الذي تتوقعه الدالة.
{| class="wikitable"
! colspan="2" |سمات الخاصية Function.length
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|نعم
|}
== الوصف ==
الخاصية <code>length</code> التابعة لكائنات <code>Function</code> تُشير إلى عدد الوسائط الذي تتوقعه الدالة، أي عدد المعاملات الرسمية (formal parameters)، وهذا العدد يستثني [[JavaScript/Rest Parameters|معامل البقية]] (rest parameter)، وسيتضمن المعاملات التي قبل أوّل معامل له [[JavaScript/Default Parameters|قيمة افتراضية]].

وفي المقابل، الخاصية <code>[[JavaScript/arguments/length|arguments.length]]</code> تابعة للدالة محليًّا، وتوفِّر عدد الوسائط التي مُرِّرَت فعليًا إلى الدالة.

=== قيمة هذه الخاصية على الدالة البانية <code>Function</code> ===
الدالة البانية <code>[[JavaScript/Function|Function]]</code> هي نفسها كائن <code>[[JavaScript/Function|Function]]</code>، وقيمة الخاصية <code>length</code> التابعة لها هي <code>1</code>.

=== قيمة هذه الخاصية على كائن prototype التابع للكائن <code>Function</code> ===
قيمة الخاصية <code>length</code> لكائن prototype للكائن <code>[[JavaScript/Function|Function]]</code> هي <code>0</code>.

== أمثلة ==
مثال يبيّن قيمة الخاصية <code>length</code> التابعة للدالة البانية <code>[[JavaScript/Function|Function]]</code>:<syntaxhighlight lang="javascript">
console.log(Function.length); // 1
</syntaxhighlight>أمثلة مختلفة عن دوال عادية:<syntaxhighlight lang="javascript">
console.log((function()        {}).length); // 0
console.log((function(a)       {}).length); // 1
console.log((function(a, b)    {}).length); // 2
</syntaxhighlight>أمثلة عن [[JavaScript/Rest Parameters|معامل البقية]] (rest parameter):<syntaxhighlight lang="javascript">
// لن يدخل معامل البقية في الحسبان
console.log((function(...args)    {}).length);  // 0
console.log((function(a, ...args) {}).length);  // 1

</syntaxhighlight>مثال عن دالة لها [[JavaScript/Default Parameters|معاملات افتراضية]]، لاحظ أنَّ القيمة المعادة هي <code>1</code> لأنَّ الخاصية <code>length</code> لن تحصي إلا المعاملات الموجودة قبل أوّل قيمة افتراضية:<syntaxhighlight lang="javascript">
console.log((function(a, b = 1, c) {}).length); // 1

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
*مسودة المعيار [https://tc39.github.io/ecma262/#sec-function-instances-length ECMAScript Latest Draft].
*معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-function-instances-length ECMAScript 2015 (6th Edition)]‎. أصبحت هذه الخاصية قابلةً للضبط (أي سمة <code>configurable</code>).
*معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.3.5.1 ECMAScript 5.1].
*معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] .
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Function]]