new.target

Exemple interactif

function Foo() {
  if (!new.target) {
    throw new TypeError("calling Foo constructor without new is invalid");
  }
}

try {
  Foo();
} catch (e) {
  console.log(e);
  // Expected output: TypeError: calling Foo constructor without new is invalid
}

Syntaxe

new.target;

Description

La syntaxe new.target se compose du mot-cl new, suivi d'un point puis d'un nom de proprit (ici target). Gnralement et par ailleurs, new. est utilis comme contexte pour accder une proprit. Ici, new. ne fait pas rellement rfrence un objet. Dans les appels de constructeurs, new.target fait rfrence au constructeur qui a t appel par new. Cette syntaxe permet donc de rcuprer cette valeur.

new.target est une mta-proprit, disponible pour toutes les fonctions. Dans les fonctions flches, new.target fait rfrence au new.target de la fonction englobante.

Exemples

Utilisation de new.target dans les appels de fonction

Utilis dans les appels de fonctions classiques (autrement dit pour les fonctions qui ne sont pas des constructeurs), new.target vaut undefined. Cela permet de dtecter si une fonction a t appele comme constructeur avec new :

function Toto() {
  if (!new.target) throw "Toto() doit tre appel avec new";
  console.log("Toto instanci avec new");
}

new Toto(); // affiche "Toto instanci avec new" dans la console
Toto(); // lve l'exception avec "Toto doit tre appel avec new"

Utilisation de new.target dans les constructeurs

Utiliss dans les appels de constructeurs de classe, new.target fait rfrence au constructeur utilis directement avec new. C'est galement le cas quand le constructeur est prsent dans une classe parente et est dlgu depuis le constructeur fils :

class A {
  constructor() {
    console.log(new.target.name);
  }
}

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

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

class C {
  constructor() {
    console.log(new.target);
  }
}

class D extends C {
  constructor() {
    super();
  }
}

var c = new C(); // function C()
var d = new D(); // function D()

Spcifications

Compatibilit des navigateurs

Voir aussi

• Les fonctions
• Les classes
• new
• this
• Cet article sur les classes traduit en franais