From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../javascript/reference/operators/new/index.md | 206 +++++++++------------ 1 file changed, 88 insertions(+), 118 deletions(-) (limited to 'files/fr/web/javascript/reference/operators/new') diff --git a/files/fr/web/javascript/reference/operators/new/index.md b/files/fr/web/javascript/reference/operators/new/index.md index 1e4074256c..7a0424c8fa 100644 --- a/files/fr/web/javascript/reference/operators/new/index.md +++ b/files/fr/web/javascript/reference/operators/new/index.md @@ -8,58 +8,51 @@ tags: translation_of: Web/JavaScript/Reference/Operators/new original_slug: Web/JavaScript/Reference/Opérateurs/L_opérateur_new --- -
{{jsSidebar("Operators")}}
+{{jsSidebar("Operators")}} -

L'opérateur new permet de créer une instance d'un certain type d'objet à partir du constructeur qui existe pour celui-ci (natif ou défini par l'utilisateur).

+L'**opérateur `new`** permet de créer une instance d'un certain type d'objet à partir du constructeur qui existe pour celui-ci (natif ou défini par l'utilisateur). -

Le mot-clé new, utilisé avec une fonction, applique les 4 étapes suivantes :

+Le mot-clé `new`, utilisé avec une fonction, applique les 4 étapes suivantes : -
    -
  1. Il crée un nouvel objet à partir de zéro
    2. -
  2. Il lie cet objet à un autre objet en le définissant comme son prototype.
    3. -
  3. Le nouvel objet, créé à l'étape 1, est passé comme valeur this à la fonction
    4. -
  4. Si la fonction ne renvoie pas d'objet, c'est la valeur this qui est renvoyée.
    5. -
+1. Il crée un nouvel objet à partir de zéro +2. Il lie cet objet à un autre objet en le définissant comme son prototype. +3. Le nouvel objet, créé à l'étape 1, est passé comme valeur `this` à la fonction +4. Si la fonction ne renvoie pas d'objet, c'est la valeur `this` qui est renvoyée. -
{{EmbedInteractiveExample("pages/js/expressions-newoperator.html")}}
+{{EmbedInteractiveExample("pages/js/expressions-newoperator.html")}} -

Syntaxe

+## Syntaxe -
new constructeur[([arguments])]
+ new constructeur[([arguments])] -

Paramètres

+### Paramètres -
-
constructeur
-
Une fonction ou une classe qui définit le type de l'objet qui sera une instance.
-
arguments
-
Une liste de valeurs correspondant aux arguments avec lesquels appeler le constructeur.
-
+- `constructeur` + - : Une fonction ou une classe qui définit le type de l'objet qui sera une instance. +- `arguments` + - : Une liste de valeurs correspondant aux arguments avec lesquels appeler le `constructeur`. -

Description

+## Description -

La création d'un objet personnalisé se fait en deux étapes :

+La création d'un objet personnalisé se fait en deux étapes : -
    -
  1. Définition du type d'objet en écrivant une fonction.
    2. -
  2. Création d'une instance de l'objet avec new.
    3. -
+1. Définition du type d'objet en écrivant une fonction. +2. Création d'une instance de l'objet avec `new`. -

Pour définir un type d'objet, créez une fonction pour ce type qui spécifie son nom, ses propriétés et ses méthodes. Un objet peut avoir des propriétés qui sont elles-mêmes des objets, comme on pourra le voir dans les exemples ci-dessous.

+Pour définir un type d'objet, créez une fonction pour ce type qui spécifie son nom, ses propriétés et ses méthodes. Un objet peut avoir des propriétés qui sont elles-mêmes des objets, comme on pourra le voir dans les exemples ci-dessous. -

Lorsque le code new Toto(...) est exécuté, voici ce qui se passe :

+Lorsque le code `new Toto(...)` est exécuté, voici ce qui se passe : -
    -
  1. Un nouvel objet est créé qui hérite de Toto.prototype.
    2. -
  2. La fonction constructrice Toto est appelée avec les arguments fournis, this étant lié au nouvel objet créé. new Toto sera équivalent à new Toto() (i.e. un appel sans argument).
    3. -
  3. L'objet renvoyé par le constructeur devient le résultat de l'expression qui contient new. Si le constructeur ne renvoie pas d'objet de façon explicite, l'objet créé à l'étape 1 sera utilisé. (En général, les constructeurs ne renvoient pas de valeurs mais si on souhaite surcharger le processus habituel, on peut utiliser cette valeur de retour).
    4. -
+1. Un nouvel objet est créé qui hérite de `Toto.prototype`. +2. La fonction constructrice `Toto` est appelée avec les arguments fournis, [`this`](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_this) étant lié au nouvel objet créé. `new Toto` sera équivalent à `new Toto()` (i.e. un appel sans argument). +3. L'objet renvoyé par le constructeur devient le résultat de l'expression qui contient `new`. Si le constructeur ne renvoie pas d'objet de façon explicite, l'objet créé à l'étape 1 sera utilisé. (En général, les constructeurs ne renvoient pas de valeurs mais si on souhaite surcharger le processus habituel, on peut utiliser cette valeur de retour). -

Il est toujours possible d'ajouter une propriété à un objet défini précédemment. Par exemple, l'instruction voiture1.couleur = "noir" ajoute une propriété couleur à voiture1, et lui assigne une valeur : "noir". Cependant, ceci n'affecte aucunement les autres objets. Pour ajouter une nouvelle propriété à tous les objets du même type, cette propriété doit être ajoutée à la définition du type d'objet Voiture.

+Il est toujours possible d'ajouter une propriété à un objet défini précédemment. Par exemple, l'instruction `voiture1.couleur = "noir"` ajoute une propriété couleur à `voiture1`, et lui assigne une valeur : "`noir`". Cependant, ceci n'affecte aucunement les autres objets. Pour ajouter une nouvelle propriété à tous les objets du même type, cette propriété doit être ajoutée à la définition du type d'objet `Voiture`. -

Il est possible d'ajouter une propriété partagée par tous les objets d'un type déjà défini auparavant en utilisant sa propriété Function.prototype. Ceci permet de définir une propriété partagée par tous les objets créés avec cette fonction, plutôt que simplement par une seule instance de ce type d'objet. Le code qui suit ajoute une propriété couleur avec la valeur "couleur standard" à tous les objets de type Voiture, et redéfinit ensuite cette valeur avec la chaîne "noir" uniquement pour l'instance d'objet voiture1. Pour plus d'informations, voir la page sur prototype.

+Il est possible d'ajouter une propriété partagée par tous les objets d'un type déjà défini auparavant en utilisant sa propriété [`Function.prototype`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Function/prototype). Ceci permet de définir une propriété partagée par tous les objets créés avec cette fonction, plutôt que simplement par une seule instance de ce type d'objet. Le code qui suit ajoute une propriété couleur avec la valeur `"couleur standard"` à tous les objets de type `Voiture`, et redéfinit ensuite cette valeur avec la chaîne "`noir`" uniquement pour l'instance d'objet `voiture1`. Pour plus d'informations, voir la page sur [prototype](/fr/docs/Web/JavaScript/Guide/Inheritance_and_the_prototype_chain). -
function Voiture() {}
+```js
+function Voiture() {}
 voiture1 = new Voiture();
 voiture2 = new Voiture();
 
@@ -75,120 +68,97 @@ console.log(voiture1.__proto__.couleur);  // couleur standard
 console.log(voiture2.__proto__.couleur);  // couleur standard
 console.log(voiture1.couleur);            // noir
 console.log(voiture2.couleur);            // couleur standard
-
+``` -
-

Note : Si on n'écrit pas l'appel du constructeur avec l'opérateur new, le constructeur est appelé comme une fonction normale et ne crée pas d'objet. Dans ce cas, la valeur de this sera différente.

-
+> **Note :** Si on n'écrit pas l'appel du constructeur avec l'opérateur `new`, le constructeur est appelé comme une fonction normale et ne crée pas d'objet. Dans ce cas, la valeur de `this` sera différente. -

Exemples

+## Exemples -

Exemple : type d'objet et instance d'objet

+### Exemple : type d'objet et instance d'objet -

Supposons que vous vouliez créer un type d'objet pour les voitures. Vous voulez que ce type d'objet s'appelle Voiture, et qu'il ait des propriétés pour la marque, le modèle et l'année. Pour ce faire, vous écririez la fonction suivante :

+Supposons que vous vouliez créer un type d'objet pour les voitures. Vous voulez que ce type d'objet s'appelle `Voiture`, et qu'il ait des propriétés pour la marque, le modèle et l'année. Pour ce faire, vous écririez la fonction suivante : -
function Voiture(marque, modèle, année) {
+```js
+function Voiture(marque, modèle, année) {
    this.marque = marque;
    this.modèle = modèle;
    this.année = année;
 }
-
+``` -

À présent, vous pouvez créer un objet appelé ma_voiture de la manière suivante :

+À présent, vous pouvez créer un objet appelé `ma_voiture` de la manière suivante : -
ma_voiture = new Voiture("Volkswagen", "Golf TDi", 1997);
-
+```js +ma_voiture = new Voiture("Volkswagen", "Golf TDi", 1997); +``` -

Cette instruction crée l'objet ma_voiture et assigne les valeurs spécifiées à ses propriétés. La valeur de ma_voiture.marque est alors la chaîne "Volkswagen", celle de ma_voiture.année est l'entier 1997, et ainsi de suite.

+Cette instruction crée l'objet `ma_voiture` et assigne les valeurs spécifiées à ses propriétés. La valeur de `ma_voiture.marque` est alors la chaîne `"Volkswagen"`, celle de `ma_voiture.année` est l'entier 1997, et ainsi de suite. -

Il est possible de créer un nombre illimité d'objets Voiture en appelant new. Par exemple :

+Il est possible de créer un nombre illimité d'objets `Voiture` en appelant `new`. Par exemple : -
voiture_de_ken = new Voiture("Nissan", "300ZX", 1992);
-
+```js +voiture_de_ken = new Voiture("Nissan", "300ZX", 1992); +``` -

Exemple : propriété d'objet qui est elle-même un autre objet

+### Exemple : propriété d'objet qui est elle-même un autre objet -

Supposons que vous ayez défini un objet appelé Personne de la manière suivante :

+Supposons que vous ayez défini un objet appelé `Personne` de la manière suivante : -
function Personne(nom, age, surnom) {
+```js
+function Personne(nom, age, surnom) {
    this.nom = nom;
    this.age = age;
    this.surnom = surnom;
 }
-
+``` -

Et que vous avez ensuite instancié deux nouveaux objets Personne de la manière suivante :

+Et que vous avez ensuite instancié deux nouveaux objets `Personne` de la manière suivante : -
rand = new Personne("Rand McNally", 33, "Randy");
+```js
+rand = new Personne("Rand McNally", 33, "Randy");
 ken = new Personne("Ken Jones", 39, "Kenny");
-
+``` -

Vous pouvez alors réécrire la définition de Voiture pour contenir une propriété propriétaire qui reçoit un objet Personne, comme ceci :

+Vous pouvez alors réécrire la définition de `Voiture` pour contenir une propriété `propriétaire` qui reçoit un objet `Personne`, comme ceci : -
function Voiture(marque, modèle, année, propriétaire) {
+```js
+function Voiture(marque, modèle, année, propriétaire) {
    this.marque = marque;
    this.modèle = modèle;
    this.année = année;
    this.propriétaire = propriétaire;
 }
-
+``` -

Pour instancier les nouveaux objets, vous utiliserez ensuite :

+Pour instancier les nouveaux objets, vous utiliserez ensuite : -
voiture1 = new Voiture("Volkswagen", "Golf TDi", 1997, rand);
+```js
+voiture1 = new Voiture("Volkswagen", "Golf TDi", 1997, rand);
 voiture2 = new Voiture("Nissan", "300ZX", 1992, ken);
-
- -

Plutôt que de passer une chaîne littérale ou une valeur entière lors de la création des nouveaux objets, les instructions ci-dessus utilisent les objets rand et ken comme paramètres pour les propriétaires. Pour connaître le nom du propriétaire de voiture2, on peut alors accéder à la propriété suivante :

- -
voiture2.propriétaire.nom
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('ESDraft', '#sec-new-operator', 'Opérateur new')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-new-operator', 'Opérateur new')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-11.2.2', 'Opérateur new')}}{{Spec2('ES5.1')}} 
{{SpecName('ES3', '#sec-11.2.2', 'Opérateur new')}}{{Spec2('ES3')}} 
{{SpecName('ES1', '#sec-11.2.2', 'Opérateur new')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.0.
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.operators.new")}}

- -

Voir aussi

- - +``` + +Plutôt que de passer une chaîne littérale ou une valeur entière lors de la création des nouveaux objets, les instructions ci-dessus utilisent les objets `rand` et `ken` comme paramètres pour les propriétaires. Pour connaître le nom du propriétaire de `voiture2`, on peut alors accéder à la propriété suivante : + +```js +voiture2.propriétaire.nom +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| ------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-new-operator', 'Opérateur new')}} | {{Spec2('ESDraft')}} |   | +| {{SpecName('ES6', '#sec-new-operator', 'Opérateur new')}} | {{Spec2('ES6')}} |   | +| {{SpecName('ES5.1', '#sec-11.2.2', 'Opérateur new')}} | {{Spec2('ES5.1')}} |   | +| {{SpecName('ES3', '#sec-11.2.2', 'Opérateur new')}} | {{Spec2('ES3')}} |   | +| {{SpecName('ES1', '#sec-11.2.2', 'Opérateur new')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | + +## Compatibilité des navigateurs + +{{Compat("javascript.operators.new")}} + +## Voir aussi + +- {{jsxref("Function")}} +- {{jsxref("Reflect.construct()")}} +- {{jsxref("Object.prototype")}} -- cgit v1.2.3-54-g00ecf