new.target

new.target プロパティは、関数やコンストラクタが new 演算子を使用して呼び出されたかどうかを検出できるようにします。コンストラクタや関数内で、new 演算子でインスタンス生成すると、new.target はコンストラクタや関数への参照を返します。通常の関数呼び出しの場合、new.target は undefined です。

構文

new.target

概要

new.target 構文は、"new" キーワードとドット、プロパティ名 "target" で構成されています。通常、"new." はプロパティアクセスへのコンテキストとして機能しますが、"new." は本当はオブジェクトではありません。しかし、コンストラクタの呼び出しで、new.target は new で実行されたコンストラクタを参照し、"new." は仮想コンテキストになります。

new.target プロパティは、すべての関数で使用できるメタプロパティです。アロー関数 では、new.target は周囲の関数の new.target を参照します。

例

関数呼び出しにおいての new.target の使用

通常の関数呼び出しでは（コンストラクタ関数の呼び出しとは反対に）、new.target は undefined です。 これは、関数がコンストラクタとして new で呼び出されたかを検出できます。

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"

コンストラクタにおいての new.target

クラスコンストラクタで、new.target は new で直接実行されたコンストラクタを参照します。これは、コンストラクタは親クラスにあり、子コンストラクタからデリゲートされた場合も同様です。

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"

仕様

ブラウザ実装状況

関連情報

• Functions
• Classes
• new
• this