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

<noinclude>{{DISPLAYTITLE:<code>Function.name</code>}}</noinclude>
الخاصية <code>Function.name</code> تُعيد اسم الدالة.
{| class="wikitable"
! colspan="2" |سمات الخاصية Function.name
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|نعم
|}
لاحظ أنَّ المتصفحات التي كانت تدعم هذه الخاصية قبل أن تصبح معياريةً (في ECMAScript 2015) كانت تضبط السمة <code>configurable</code> إلى <code>false</code> (أي أنَّ هذه الخاصية غير قابلة للضبط).

== أمثلة ==

=== اسم دالة مُصرَّح عنها ===
الخاصية <code>name</code> تُعيد اسم الدالة المستخدم في تعبير [[JavaScript/function|التصريح عن الدوال]]:<syntaxhighlight lang="javascript">
function doSomething() {}
doSomething.name; // "doSomething"

</syntaxhighlight>

=== اسم دالة مُعرَّفة عبر الدالة البانية <code>Function</code> ===
الدوال المُنشَأة عبر البنية <code>new Function(...)‎</code> أو <code>Function(...)‎</code> تؤدي إلى إنشاء كائنات <code>[[JavaScript/Function|Function]]</code> ويكون اسم تلك الدوال هو <code>anonymous</code>:<syntaxhighlight lang="javascript">
(new Function).name; // "anonymous"

</syntaxhighlight>

=== الاستدلال على أسماء الدوال ===
يمكن للمتغيرات والدوال الدلالة على اسم دالة مجهولة (anonymous function) من مكانها البنيوي (ميزة جديدة في ECMAScript 2015):<syntaxhighlight lang="javascript">
var f = function() {};
var object = {
  someMethod: function() {}
};

console.log(f.name); // "f"
console.log(object.someMethod.name); // "someMethod"

</syntaxhighlight>لاحظ أنَّ بالإمكان تعريف دالة عبر [[JavaScript/Function Expression|تعابير تعريف الدوال]] (function expression) ويكون تلك الدالة اسمٌ مرتبطٌ بها:<syntaxhighlight lang="javascript">
var object = {
  someMethod: function object_someMethod() {}
};
console.log(object.someMethod.name); // "object_someMethod"

try { object_someMethod } catch(e) { console.log(e); }
// ReferenceError: object_someMethod is not defined

</syntaxhighlight>لا يمكن تعديل اسم الدالة، لأنَّ هذه الخاصية للقراءة فقط:<syntaxhighlight lang="javascript">
var object = {
  // anonymous
  someMethod: function() {}
};

object.someMethod.name = 'otherMethod';
console.log(object.someMethod.name); // someMethod

</syntaxhighlight>لكن يمكن استخدام الدالة <code>[[JavaScript/Object/defineProperty|Object.defineProperty()‎]]</code> لتعديل الاسم:<syntaxhighlight lang="javascript">
var object = {
  // anonymous
  someMethod: function() {}
};

Object.defineProperty(object.someMethod, 'name', { value: 'otherMethod' });
console.log(object.someMethod.name); // otherMethod
</syntaxhighlight>

=== أسماء الدوال المُعرَّفة بالطريقة المختصرة ===
<syntaxhighlight lang="javascript">
var o = {
  foo(){}
};
o.foo.name; // "foo";
</syntaxhighlight>

=== أسماء الدوال المرتبطة بالكائنات ===
الدالة <code>[[JavaScript/Function/bind|Function.bind()]]</code>‎ تؤدي إلى إضافة الكلمة <code>"bound"</code> قبل اسم الدالة:<syntaxhighlight lang="javascript">
function foo() {}; 
foo.bind({}).name; // "bound foo"

</syntaxhighlight>

=== أسماء دوال getter و setter ===
عند استخدام خاصيات [[JavaScript/get|getter]] و [[JavaScript/set|setter]]، فستُظهِر الكلمة <code>"get"</code> أو <code>"set"</code> قبل اسم الدالة؛ لاحظ كيف استخدمنا الدالة <code>[[JavaScript/Object/getOwnPropertyDescriptor|getOwnPropertyDescriptor]]</code> للحصول على مرجعية لهذه الخاصيات:<syntaxhighlight lang="javascript">
var o = { 
  get foo(){}, 
  set foo(x){} 
}; 

var descriptor = Object.getOwnPropertyDescriptor(o, "foo"); 
descriptor.get.name; // "get foo" 
descriptor.set.name; // "set foo";

</syntaxhighlight>

=== أسماء الدوال في الأصناف ===
يمكنك استخدام الخاصية <code>obj.constructor.name</code> لمعرفة ما هو «صنف» الكائن:<syntaxhighlight lang="javascript">
function Foo() {}  // ES2015 Syntax: class Foo {}

var fooInstance = new Foo();
console.log(fooInstance.constructor.name); // "Foo"
</syntaxhighlight>تحذير: ستكون هذه الخاصية متاحةً فقط إذا لم تُعرِّف الدالة البانية خاصيةً تابعةً لها باسم <code>name</code>. وهذا يعني أنَّ عليك ألّا تعتمد على الخاصية <code>Function.name</code> للحصول على اسم الصنف.

=== استخدام الرموز كأسماء دوال ===
إذا استخدمنا رمزًا <code>[[JavaScript/Symbol|Symbol]]</code>، اسمًا للدالة، وكان لهذا الرمز وصفٌ، فسيكون اسم الدالة هو وصف الرمز لكن بين قوسين مربعين:<syntaxhighlight lang="javascript">
var sym1 = Symbol("foo"); 
var sym2 = Symbol(); 
var o = { 
  [sym1]: function(){}, 
  [sym2]: function(){} 
}; 

o[sym1].name; // "[foo]"
o[sym2].name; // ""
</syntaxhighlight>

== تصغير حجم ملفات JavaScript ==
خذ حذرك عند استخدام الخاصية <code>Function.name</code> عند وجود احتمال لحدوث تغييرات في الشيفرة، كالتي تحدث عند تصغير حجم ملفات JavaScript، فتُستخدَم أدوات الضغط وتصغير حجم ملفات JavaScript كجزء من آلية نشر برمجيات JavaScript. مثل هذه التحويلات تُغيّر اسم الدوال في وقت البناء عادةً.

فمثلًا، الشيفرة الآتية:<syntaxhighlight lang="javascript">
function Foo() {};
var foo = new Foo();

if (foo.constructor.name === 'Foo') {
  console.log("'foo' is an instance of 'Foo'");
} else {
  console.log('Oops!');
}
</syntaxhighlight>يمكن أن تُضغَط إلى:<syntaxhighlight lang="javascript">
function a() {};
var b = new a();
if (b.constructor.name === 'Foo') {
  console.log("'foo' is an instance of 'Foo'");
} else {
  console.log('Oops!');
}
</syntaxhighlight>ففي النسخة غير المضغوطة، كانت نتيجة الشرط هي <code>true</code>، بينما في النسخة المضغوطة كانت <code>false</code>؛ لذا إذا كنت تعتمد على قيمة الخاصية <code>Function.name</code> كما في المثال السابق، فاحرص على ضبط برمجيات الضغط لكي لا تُغيّر أسماء الدوال، أو افترض عدم امتلاك الدالة لاسمٍ معيّن عند برمجتك لها.

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|15
|نعم
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
*مسودة المعيار [https://tc39.github.io/ecma262/#sec-name ECMAScript Latest Draft].
*معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-name ECMAScript 2015 (6th Edition)]‎.
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Function|{{SUBPAGENAME}}]]