عرض مصدر JavaScript/new.target

<noinclude>{{DISPLAYTITLE:<code>new.target</code>}}</noinclude>
الخاصية <code>new.target</code> تسمح لك بمعرفة إن استدعيت دالةٌ عاديةٌ أم دالةٌ بانيةٌ باستخدام المعامل <code>[[JavaScript/new|new]]</code>، ففي الدوال البانية التي تُهيَّئ باستخدام المعامل <code>[[JavaScript/new|new]]</code> ستعيد الخاصية <code>new.target</code> مرجعيةً إلى الدالة البانية، أما الدوال العادية فستكون قيمة الخاصية <code>new.target</code> هي <code>[[JavaScript/undefined|undefined]]</code>.
==البنية العامة==
<syntaxhighlight lang="javascript">
new.target

</syntaxhighlight>

== الوصف ==
التعبير <code>new.target</code> يحتوي على الكلمة المحجوزة <code>new</code> ثم نقطة ثم اسم الخاصية <code>target</code>، لاحظ أنَّ هذا الشكل قد يبدو من الوهلة الأولى على أنها [[JavaScript/Property Accessors|وصولٌ إلى خاصيات]] أحد الكائنات، لن الكلمة المحجوزة <code>new</code> ليست كائنًا.

الخاصية <code>new.target</code> هي خاصية وصفية متوافرة لجميع الدوال؛ وستشير الخاصية <code>new.target</code> في [[JavaScript/Arrow Functions|الدوال السهمية]] إلى قيمة <code>new.target</code> للدالة المُحيطة بالدالة السهمية.

== أمثلة ==

=== <code>new.target</code> عند استدعاء الدوال ===
عند استدعاء الدوال العادية (أي أنَّ الدالة ليست دالةً بانيةً)، فستكون قيمة <code>new.target</code> هي <code>[[JavaScript/undefined|undefined]]</code>، وهذا يسمح بمعرفة إن استدعيت هذه الدالة باستخدام المعامل <code>[[JavaScript/new|new]]</code> كدالة بانية:<syntaxhighlight lang="javascript">
function Foo() {
  if (!new.target) throw 'Foo() must be called with new';
  console.log('Foo instantiated with new');
}

Foo(); // throws "Foo() must be called with new"
new Foo(); // logs "Foo instantiated with new"

</syntaxhighlight>

=== <code>new.target</code> في الدوال البانية ===
تُشير الخاصية <code>new.target</code> في الدوال البانية للأصناف إلى الدالة البانية التي اُستدعيت مباشرةً عبر المعامل <code>[[JavaScript/new|new]]</code>، وهذا ينطبق على الدالة البانية التي تكون في الصنف الأب التي استدعيت من الدالة البانية للصنف الابن:<syntaxhighlight lang="javascript">
class A {
  constructor() {
    console.log(new.target.name);
  }
}

class B extends A { constructor() { super(); } }

var a = new A(); // logs "A"
var b = new B(); // logs "B"

class C { constructor() { console.log(new.target); } }
class D extends C { constructor() { super(); } }
 
var c = new C(); // logs class C{constructor(){console.log(new.target);}}
var d = new D(); // logs class D extends C{constructor(){super();}}

</syntaxhighlight>لاحظ من المثال السابق في الصنفين C و D أنَّ الخاصية <code>new.target</code> تُشير إلى تعريف الصنف الذي تمت تهيئته، فعند تهيئة الصنف D باستخدام المعامل <code>[[JavaScript/new|new]]</code> فسيُعرَض تعريف الصنف D، والمثل ينطبق على الصنف C.

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

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