Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

new — appeler un constructeur

L’opérateur new appelle un constructeur avec les arguments fournis et renvoie un objet. Avec une fonction constructeur ordinaire, il crée un objet lié à son prototype et le rend disponible dans la fonction sous le nom this.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Constructor(arg1, arg2)
new Constructor()

new est un mot-clé qui sert à appeler un constructeur : new Constructor(arg1, arg2). Sans argument, vous pouvez écrire new Constructor() ou omettre les parenthèses : new Constructor. La présence explicite de () rend l’intention plus facile à lire. new est un mot réservé et ne peut donc pas être un nom de variable.

Avec une fonction constructeur ordinaire, new crée un objet, définit son prototype interne sur Constructor.prototype si cette valeur est un objet, puis exécute la fonction avec le nouvel objet comme this. Si Constructor.prototype n’est pas un objet, un prototype d’objet par défaut approprié est utilisé à la place. Les arguments sont transmis aux paramètres de la fonction.

Si un tel constructeur renvoie explicitement un objet, cet objet remplace le résultat de la construction. Une valeur primitive renvoyée, y compris null, est ignorée. Cela décrit les constructeurs de base ; les constructeurs de classes dérivées suivent des règles supplémentaires concernant super() et les valeurs de retour.

Toutes les fonctions ne sont pas des constructeurs : les fonctions fléchées ne prennent pas en charge new, et tenter de les utiliser ainsi provoque une TypeError. Une classe doit être appelée par construction, et non par un appel ordinaire tel que Constructor(). new est un mécanisme du langage ECMAScript, pas une API Web ; la disponibilité d’un constructeur donné est une question distincte.

Exemples

function User(name) {
  this.name = name;
}

const user = new User("Ada");
console.log(user.name);
console.log(Object.getPrototypeOf(user) === User.prototype);

Résultat

Ada
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources