Merge pull request #285 from javascript-tutorial/sync-7533c719

Sync with upstream @ 7533c71

Author: HachemiH

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -12,7 +12,11 @@ Une nouvelle version de la spécification est publiée chaque année. La derniè
 
 Pour en savoir plus sur les fonctionnalités à venir, y compris celles qui sont "presque standards" (appelées aussi "stage 3"), vous pouvez consulter les propositions à cette adresse : <https://github.com/tc39/proposals>.
 
+<<<<<<< HEAD
 Si vous développez spécifiquement pour le navigateur, il existe d’autres spécifications couvertes dans la [seconde partie](info:browser-environment) du tutoriel.
+=======
+Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 ## Manuels
 

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/solution.md

@@ -9,9 +9,14 @@ true + false = 1
 "$" + 4 + 5 = "$45"
 "4" - 2 = 2
 "4px" - 2 = NaN
+<<<<<<< HEAD
 7 / 0 = Infinity
 " -9  " + 5 = " -9  5" // (3)
 " -9  " - 5 = -14 // (4)
+=======
+"  -9  " + 5 = "  -9  5" // (3)
+"  -9  " - 5 = -14 // (4)
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 null + 1 = 1 // (5)
 undefined + 1 = NaN // (6)
 " \t \n" - 2 = -2 // (7)

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/task.md

@@ -16,9 +16,14 @@ true + false
 "$" + 4 + 5
 "4" - 2
 "4px" - 2
+<<<<<<< HEAD
 7 / 0
 "  -9\n" + 5
 "  -9\n" - 5
+=======
+"  -9  " + 5
+"  -9  " - 5
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 null + 1
 undefined + 1
 " \t \n" - 2

1-js/02-first-steps/10-ifelse/2-check-standard/task.md

@@ -6,7 +6,11 @@ importance: 2
 
 En utilisant la construction `if..else`, écrivez le code qui demande : 'Quel est le nom "officiel" de JavaScript?'
 
+<<<<<<< HEAD
 Si le visiteur entre “ECMAScript”, alors éditez “Bonne réponse !”, Sinon -- retourne “Ne sait pas ? ECMAScript!"
+=======
+If the visitor enters "ECMAScript", then output "Right!", otherwise -- output: "You don't know? ECMAScript!"
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 ![](ifelse_task2.svg)
 

1-js/02-first-steps/11-logical-operators/article.md

@@ -1,6 +1,10 @@
 # Opérateurs logiques
 
+<<<<<<< HEAD
 Il y a trois opérateurs logiques en JavaScript : `||` (OR), `&&` (AND), `!` (NOT).
+=======
+There are four logical operators in JavaScript: `||` (OR), `&&` (AND), `!` (NOT), `??` (Nullish Coalescing). Here we cover the first three, the `??` operator is in the next article.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 Bien qu'ils soient appelés "logiques", ils peuvent être appliqués à des valeurs de tout type, pas seulement booléennes. Le résultat peut également être de tout type.
 

1-js/02-first-steps/12-nullish-coalescing-operator/article.md

@@ -2,6 +2,7 @@
 
 [recent browser="new"]
 
+<<<<<<< HEAD
 Ici, dans cet article, nous dirons qu'une expression est `defined` lorsqu'elle n'est ni `null` ni `undefined`.
 
 L'opérateur de coalescence des nuls est écrit sous la forme de deux points d'interrogation `??`.
@@ -12,6 +13,17 @@ Le résultat de `a ?? b` est :
 
 
 En d'autres termes, `??` renvoie le premier argument s'il n'est pas `nul/undefined`. Sinon, le second.
+=======
+The nullish coalescing operator is written as two question marks `??`.
+
+As it treats `null` and `undefined` similarly, we'll use a special term here, in this article. We'll say that an expression is "defined" when it's neither `null` nor `undefined`.
+
+The result of `a ?? b` is:
+- if `a` is defined, then `a`,
+- if `a` isn't defined, then `b`.
+
+In other words, `??` returns the first argument if it's not `null/undefined`. Otherwise, the second one.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 L'opérateur de coalescence des nuls n'est pas complètement nouveau. C'est juste une belle syntaxe pour obtenir la première valeur "defined" des deux.
 
@@ -21,29 +33,47 @@ Nous pouvons réécrire `result = a ?? b` en utilisant les opérateurs que nous
 result = (a !== null && a !== undefined) ? a : b;
 ```
 
+<<<<<<< HEAD
 Le cas d'utilisation courant de `??` est de fournir une valeur par défaut pour une variable potentiellement indéfinie.
 
 Par exemple, ici nous montrons `Anonymous` si `user` n'est pas défini :
+=======
+Now it should be absolutely clear what `??` does. Let's see where it helps.
+
+The common use case for `??` is to provide a default value for a potentially undefined variable.
+
+For example, here we show `user` if defined, otherwise `Anonymous`:
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 ```js run
 let user;
 
-alert(user ?? "Anonymous"); // Anonymous
+alert(user ?? "Anonymous"); // Anonymous (user not defined)
 ```
 
+<<<<<<< HEAD
 Bien sûr, si `user` avait une valeur à l'exception de `null/undefined`, alors nous la verrions à la place :
+=======
+Here's the example with `user` assigned to a name:
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 ```js run
 let user = "John";
 
-alert(user ?? "Anonymous"); // John
+alert(user ?? "Anonymous"); // John (user defined)
 ```
 
 Nous pouvons également utiliser une séquence de `??` pour sélectionner la première valeur dans une liste qui n'est pas `null/undefined`.
 
+<<<<<<< HEAD
 Disons que nous avons les données d'un utilisateur dans les variables `firstName`, `lastName` ou `nickName`. Tous peuvent être indéfinis, si l'utilisateur décide de ne pas entrer de valeur.
 
 Nous aimerions afficher le nom d'utilisateur en utilisant l'une de ces variables, ou afficher "Anonymous" si toutes ne sont pas définies.
+=======
+Let's say we have a user's data in variables `firstName`, `lastName` or `nickName`. All of them may be not defined, if the user decided not to enter a value.
+
+We'd like to display the user name using one of these variables, or show "Anonymous" if all of them aren't defined.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 Utilisons l'opérateur `??` pour cela :
 
@@ -74,7 +104,11 @@ alert(firstName || lastName || nickName || "Anonymous"); // Supercoder
 */!*
 ```
 
+<<<<<<< HEAD
 L'opérateur OR `||` existe depuis le début de JavaScript, donc les développeurs l'utilisaient à de telles fins depuis longtemps.
+=======
+Historically, the OR `||` operator was there first. It exists since the beginning of JavaScript, so developers were using it for such purposes for a long time.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 D'un autre côté, l'opérateur de coalescence des nuls `??` n'a été ajouté à JavaScript que récemment, et la raison en était que les gens n'étaient pas tout à fait satisfaits de `||`.
 
@@ -95,6 +129,7 @@ alert(height || 100); // 100
 alert(height ?? 100); // 0
 ```
 
+<<<<<<< HEAD
 - L'expression `height || 100` vérifie que "height" est une valeur erronée, et c'est vraiment le cas,
     - donc le résultat est le deuxième argument, `100`.
 - L'expression `height ?? 100` vérifie que `height` est `null/undefined`, et ce n'est pas le cas,
@@ -103,10 +138,24 @@ alert(height ?? 100); // 0
 Si la hauteur zéro est une valeur valide, elle ne doit pas être remplacée par la valeur par défaut, alors `??` fait exactement ce qu'il faut.
 
 ## Priorité
+=======
+- The `height || 100` checks `height` for being a falsy value, and it's `0`, falsy indeed.
+    - so the result of `||` is the second argument, `100`.
+- The `height ?? 100` checks `height` for being `null/undefined`, and it's not,
+    - so the result is `height` "as is", that is `0`.
+
+In practice, the zero height is often a valid value, that shouldn't be replaced with the default. So `??` does just the right thing.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 La priorité de l'opérateur `??` est plutôt faible : `5` dans le [tableau MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table).
 
+<<<<<<< HEAD
 La priorité de l'opérateur «??» est plutôt faible: «5» dans le [tableau MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table). Ainsi, `??` est évalué avant `=` et `?`, Mais après la plupart des autres opérations, telles que `+`, `*`.
+=======
+The precedence of the `??` operator is about the same as `||`, just a bit lower. It equals `5` in the [MDN table](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table), while `||` is `6`.
+
+That means that, just like `||`, the nullish coalescing operator `??` is evaluated before `=` and `?`, but after most other operations, such as `+`, `*`.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 Donc, si nous voulons choisir une valeur avec `??` dans une expression avec d'autres opérateurs, pensez à ajouter des parenthèses :
 
@@ -140,7 +189,11 @@ Le code ci-dessous déclenche une erreur de syntaxe :
 let x = 1 && 2 ?? 3; // Syntax error
 ```
 
+<<<<<<< HEAD
 La limitation est sûrement discutable, mais elle a été ajoutée à la spécification du langage dans le but d'éviter les erreurs de programmation, car les gens commencent à passer à `??` à partir de `||`.
+=======
+The limitation is surely debatable, it was added to the language specification with the purpose to avoid programming mistakes, when people start to switch from `||` to `??`.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 Utilisez des parenthèses explicites pour la contourner :
 

1-js/02-first-steps/17-arrow-functions-basics/article.md

@@ -5,15 +5,15 @@ Il existe une syntaxe plus simple et concise pour créer des fonctions, c'est so
 Les "fonctions fléchées" sont appelées ainsi pour leur syntaxe :
 
 ```js
-let func = (arg1, arg2, ...argN) => expression
+let func = (arg1, arg2, ..., argN) => expression
 ```
 
 ...Cela va créér une function `func` qui accepte les arguments `arg1...argN`, puis évalue l'`expression` sur le côté droit et retourne le résultat.
 
 C'est donc la version raccourcie de :
 
 ```js
-let func = function(arg1, arg2, ...argN) {
+let func = function(arg1, arg2, ..., argN) {
   return expression;
 };
 ```

1-js/04-object-basics/02-object-copy/article.md

@@ -187,7 +187,13 @@ let clone = Object.assign({}, user);
 
 Cela copie toutes les propriétés de `user` dans l'objet vide et le retourne.
 
+<<<<<<< HEAD
 ## Clonage imbriqué
+=======
+There are also other methods of cloning an object, e.g. using the [spread operator](info:rest-parameters-spread) `clone = {...user}`, covered later in the tutorial.
+
+## Nested cloning
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 Jusqu'à maintenat on suppose que toutes les propriétés de `use` sont des primitives. Mais les propriétés peuvent être des références vers d'autres objets. Comment gèrer ces cas-là ?
 

1-js/04-object-basics/04-object-methods/8-chain-calls/solution.md

@@ -21,7 +21,7 @@ let ladder = {
     return this;
 */!*
   }
-}
+};
 
 ladder.up().up().down().up().down().showStep(); // 1
 ```

1-js/04-object-basics/07-optional-chaining/article.md

@@ -175,9 +175,15 @@ userGuest.admin?.(); // nothing (no such method)
 */!*
 ```
 
+<<<<<<< HEAD
 
 Ici, dans les deux lignes, nous utilisons d'abord le point (`user1.admin`) pour obtenir la propriété `admin`, car l'objet utilisateur doit exister, donc il peut être lu en toute sécurité.
 Puis `?.()` Vérifie la partie gauche : si la fonction admin existe, alors elle s'exécute (c'est le cas pour `user1`). Sinon (pour `user2`) l'évaluation s'arrête sans erreur.
+=======
+Here, in both lines we first use the dot (`userAdmin.admin`) to get `admin` property, because we assume that the user object exists, so it's safe read from it.
+
+Then `?.()` checks the left part: if the admin function exists, then it runs (that's so for `userAdmin`). Otherwise (for `userGuest`) the evaluation stops without errors.
+>>>>>>> 7533c719fbf62ba57188d6d51fe4c038b282bd0c
 
 
 La syntaxe `?.[]` Fonctionne également, si nous voulons utiliser des crochets `[]` pour accéder aux propriétés au lieu du point `.`. Similaire aux cas précédents, il permet de lire en toute sécurité une propriété à partir d'un objet qui peut ne pas exister.