Merge pull request #336 from HachemiH/master

Conflicts fixed after sync with upstream @ eda333d

Author: HachemiH

1-js/01-getting-started/1-intro/article.md

@@ -26,19 +26,11 @@ Le navigateur a un moteur intégré, parfois il peut être également appelé "l
 
 Différents moteurs ont différents "nom de code", par exemple:
 
-<<<<<<< HEAD
 - [V8](<https://fr.wikipedia.org/wiki/V8_(moteur_JavaScript)>) -- dans Chrome et Opera.
 - [SpiderMonkey](https://fr.wikipedia.org/wiki/SpiderMonkey) -- dans Firefox.
 - … Il existe d'autres noms de code comme "Chakra" pour IE, "JavaScriptCore", "Nitro" et "SquirrelFish" pour Safari etc.
 
 Les termes ci-dessus sont bons à retenir, car ils sont utilisés dans les articles destinés aux développeurs sur Internet. Nous les utiliserons aussi. Par exemple, si "une fonctionnalité X est prise en charge par V8", cela fonctionne probablement dans Chrome et Opera.
-=======
-- [V8](https://en.wikipedia.org/wiki/V8_(JavaScript_engine)) -- in Chrome, Opera and Edge.
-- [SpiderMonkey](https://en.wikipedia.org/wiki/SpiderMonkey) -- in Firefox.
-- ...There are other codenames like "Chakra" for IE, "JavaScriptCore", "Nitro" and "SquirrelFish" for Safari, etc.
-
-The terms above are good to remember because they are used in developer articles on the internet. We'll use them too. For instance, if "a feature X is supported by V8", then it probably works in Chrome, Opera and Edge.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 ```smart header="Comment fonctionnent les moteurs ?"
 

1-js/01-getting-started/3-code-editors/article.md

@@ -34,20 +34,11 @@ En pratique, les éditeurs légers peuvent avoir beaucoup de plug-ins, y compris
 Les options suivantes méritent votre attention :
 
 - [Atom](https://atom.io/) (multiplateforme, gratuit).
-- Visual Studio Code (multiplateforme, gratuit).
 - [Sublime Text](http://www.sublimetext.com) (multiplateforme, payant).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, gratuit).
 - [Vim](http://www.vim.org/) et [Emacs](https://www.gnu.org/software/emacs/) sont également cool, si vous savez comment les utiliser.
 
 
-<<<<<<< HEAD
-=======
-- [Atom](https://atom.io/) (cross-platform, free).
-- [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware).
-- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
-- [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
-
 ## Ne discutons pas
 
 Les éditeurs des listes ci-dessus sont ceux que moi-même ou mes amis, que je considère comme de bons développeurs, utilisent depuis longtemps et en sont satisfaits.

1-js/02-first-steps/09-comparison/article.md

@@ -4,17 +4,10 @@ Il y a de nombreux opérateurs de comparaison que nous connaissons des mathémat
 
 - Plus grand/petit que : <code>a &gt; b</code>, <code>a &lt; b</code>.
 - Plus grand/petit ou égal à : <code>a &gt;= b</code>, <code>a &lt;= b</code>.
-- Le contrôle d'égalité est écrit en tant que `a == b` (veuillez noter le signe de la double équation `=`. Un seul symbole `a = b` signifierait une affectation).
-- Pas égal. En maths, la notation est `≠`, en JavaScript, elle est écrite comme une assignation avec un signe d’exclamation : <code>a != b</code>.
+- Égalité : `a == b` (veuillez noter le signe de la double égalité `==` signifie un test d’égalité. Un seul symbole `a = b` signifierait une affectation).
+- Pas égal : en maths la notation est <code>&ne;</code>, mais en JavaScript elle est écrite comme une assignation avec un signe d’exclamation : <code>a != b</code>.
 
-<<<<<<< HEAD
 Dans cet article, nous en apprendrons plus sur les différents types de comparaisons, sur la façon dont JavaScript les fait, y compris sur les particularités importantes.
-=======
-- Greater/less than: <code>a &gt; b</code>, <code>a &lt; b</code>.
-- Greater/less than or equals: <code>a &gt;= b</code>, <code>a &lt;= b</code>.
-- Equals: `a == b`, please note the double equality sign `==` means the equality test, while a single one `a = b` means an assignment.
-- Not equals: In maths the notation is <code>&ne;</code>, but in JavaScript it's written as <code>a != b</code>.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 À la fin, vous trouverez une bonne recette pour éviter les problèmes liés aux "bizarreries JavaScript".
 

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

@@ -123,11 +123,7 @@ Cela conduit à des usages intéressants par rapport à un "OR pur, classique, b
 
     Cela signifie que `||` traite ses arguments jusqu'à ce que la première valeur de vérité soit atteinte, puis la valeur est renvoyée immédiatement, sans même toucher l'autre argument.
 
-<<<<<<< HEAD
     L'importance de cette fonctionnalité devient évidente si un opérande n'est pas seulement une valeur, mais une expression avec un effet secondaire, comme une affectation de variable ou un appel de fonction.
-=======
-    The importance of this feature becomes obvious if an operand isn't just a value, but an expression with a side effect, such as a variable assignment or a function call.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
     Dans l'exemple ci-dessous, seul le deuxième message est imprimé :
 

1-js/03-code-quality/02-coding-style/article.md

@@ -307,19 +307,11 @@ Ce qui est génial avec eux, c'est que la vérification du style trouve égaleme
 
 Voici quelques linters bien connus :
 
-<<<<<<< HEAD
 - [JSLint](http://www.jslint.com/) -- l'un des premiers linters.
 - [JSHint](http://www.jshint.com/) -- plus de paramètres que JSLint.
 - [ESLint](http://eslint.org/) -- probablement le plus récent.
 
 Tous peuvent faire le travail. L'auteur utilise [ESLint](http://eslint.org/).
-=======
-- [JSLint](https://www.jslint.com/) -- one of the first linters.
-- [JSHint](https://jshint.com/) -- more settings than JSLint.
-- [ESLint](https://eslint.org/) -- probably the newest one.
-
-All of them can do the job. The author uses [ESLint](https://eslint.org/).
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 La plupart des linters sont intégrés aux éditeurs: il suffit d'activer le plug-in dans l'éditeur et de configurer le style.
 
@@ -351,14 +343,6 @@ Ici, la directive `"extends"` indique que nous nous basons sur l'ensemble de par
 
 Il est aussi possible de télécharger des ensembles de règles de style à partir du Web et de les étendre. Voir <http://eslint.org/docs/user-guide/getting-started> pour plus de détails sur l'installation.
 
-L'utilisation d'un linter a un effet secondaire formidable: les linters prennent les fautes de frappe. Par exemple, quand on accède à une variable non définie, un linter la détecte et (s'il est intégrée à un éditeur) la met en évidence. Dans la plupart des cas, il s’agit d’un mauvais type. Nous pouvons donc régler le problème tout de suite.
-
-<<<<<<< HEAD
-Pour cette raison, même si vous n’êtes pas préoccupé par les styles, il est vivement recommandé d’utiliser un linter.
-=======
-It is also possible to download style rule sets from the web and extend them instead. See <https://eslint.org/docs/user-guide/getting-started> for more details about installation.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
-
 De plus, certains IDE prennent en charge le linting nativement, ce qui peut également être bien, mais pas aussi ajustables que ESLint.
 
 ## Résumé

1-js/05-data-types/01-primitives-methods/article.md

@@ -48,11 +48,7 @@ La solution semble peu commode, mais la voici:
 2. Le langage permet d'accéder aux méthodes et aux propriétés des chaînes de caractères, des nombres, des booléens et des symboles.
 3. Pour que cela fonctionne, un "wrapper d'objet" (conteneur)  spécial est crée pour fournir la fonctionnalité supplémentaire, puis il est détruit.
 
-<<<<<<< HEAD
 Les "wrapper d'objets" (conteneurs) sont différents pour chaque type de primitive et sont appelés: `String`, `Number`, `Boolean` et `Symbol`. Ainsi, ils fournissent différents ensembles de méthodes.
-=======
-The "object wrappers" are different for each primitive type and are called: `String`, `Number`, `Boolean`, `Symbol` and `BigInt`. Thus, they provide different sets of methods.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 Par exemple, il existe une méthode de string [str.toUpperCase()](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase) qui renvoie une chaîne de caractères `str` en majuscule. 
 

1-js/06-advanced-functions/01-recursion/05-output-single-linked-list-reverse/solution.md

@@ -33,11 +33,7 @@ printReverseList(list);
 
 # En utilisant une boucle
 
-<<<<<<< HEAD
 La variante de boucle est aussi un peu plus compliquée que la sortie directe.
-=======
-The loop variant is also a little bit more complicated than the direct output.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 Il n'y a aucun moyen d'obtenir la dernière valeur de notre `list`. Nous ne pouvons pas non plus "revenir en arrière".
 

1-js/11-async/03-promise-chaining/article.md

@@ -34,29 +34,17 @@ new Promise(function(resolve, reject) {
 
 L'idée est que le résultat est transmis à travers la chaîne de gestionnaires `.then`.
 
-<<<<<<< HEAD
-Ici, le flux est:
+Ici, le flux est :
 1. La promesse initiale est résolue en 1 seconde `(*)`,
-2. Ensuite, le gestionnaire `.then` est appelé `(**)`.
-3. La valeur qu'elle renvoie est transmise au prochain gestionnaire `.then` `(***)`
+2. Ensuite, le gestionnaire `.then` est appelé `(**)`, qui à son tour crée une nouvelle promesse (résolue avec la valeur `2`).
+3. Le `then` suivant `(***)` obtient le résultat du précédent, le traite (double) et passe le gestionnaire suivant.
 4. ...et ainsi de suite.
-=======
-Here the flow is:
-1. The initial promise resolves in 1 second `(*)`,
-2. Then the `.then` handler is called `(**)`, which in turn creates a new promise (resolved with `2` value).
-3. The next `then` `(***)` gets the result of the previous one, processes it (doubles) and passes the next handler.
-4. ...and so on.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
 
 Lorsque le résultat est transmis le long de la chaîne de gestionnaires, nous pouvons voir une séquence d'appels `alert`: `1` -> `2` -> `4`.
 
 ![](promise-then-chain.svg)
 
-<<<<<<< HEAD
-Le tout fonctionne, car un appel à `promise.then` renvoie une promesse, de sorte que nous puissions appeler le prochain` .then` dessus.
-=======
-The whole thing works, because every call to a `.then` returns a new promise, so that we can call the next `.then` on it.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
+Le tout fonctionne, parce qu’un appel à `.then` renvoie une nouvelle promesse, de sorte que nous puissions appeler le prochain` .then` dessus.
 
 Lorsqu'un gestionnaire renvoie une valeur, cela devient le résultat de cette promesse. Le prochain `.then` est appelé avec.
 

2-ui/4-forms-controls/3-events-change-input/article.md

@@ -49,7 +49,7 @@ Si nous voulons gérer chaque modification d'un `<input>` alors cet événement
 D'un autre coté, l'événement `input` ne se déclenche pas lors de la saisie au clavier et d'autres actions qui n'impliquent de changement de valeur, par ex. en appuyant sur les touches fléchées `touche:⇦` `touche:⇨` pendant la saisie.
 
 ```
-smart header="Can't prevent anything in `oninput`"
+smart header="Impossible d'empêcher quoi que ce soit dans `oninput`"
 L'événement `input` se produit après la modification de la valeur.
 
 Nous ne pouvons donc pas utiliser `event.preventDefault()` - c'est trop tard, il n'y aurait aucun effet.
@@ -59,19 +59,11 @@ Nous ne pouvons donc pas utiliser `event.preventDefault()` - c'est trop tard, il
 
 Ces événements se produisent lors de la coupe/copie/collage d'une valeur.
 
-<<<<<<< HEAD
-Ils appartiennent à la classe [ClipboardEvent](https://www.w3.org/TR/clipboard-apis/#clipboard-event-interfaces) et permettent d'accéder aux données copiées/collées.
-=======
-They belong to [ClipboardEvent](https://www.w3.org/TR/clipboard-apis/#clipboard-event-interfaces) class and provide access to the data that is cut/copied/pasted.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
+Ils appartiennent à la classe [ClipboardEvent](https://www.w3.org/TR/clipboard-apis/#clipboard-event-interfaces) et permettent d'accéder aux données coupées/copiées/collées.
 
 Nous pouvons également utiliser `event.preventDefault()` pour interrompre l'action, puis rien n'est copié/collé.
 
-<<<<<<< HEAD
-Par exemple, le code ci-dessous empêche tous ces événements et montre ce que nous essayons de couper/copier/coller:
-=======
-For instance, the code below prevents all `cut/copy/paste` events and shows the text we're trying to cut/copy/paste:
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
+Par exemple, le code ci-dessous empêche tous ces événements `cut/copy/paste` et montre ce que nous essayons de couper/copier/coller:
 
 ```html autorun height=40 run
 <input type="text" id="input">
@@ -88,54 +80,36 @@ For instance, the code below prevents all `cut/copy/paste` events and shows the
 </script>
 ```
 
-<<<<<<< HEAD
-Veuillez noter qu'il est possible de copier/coller non seulement du texte, mais tout. Par exemple, nous pouvons copier un fichier dans le gestionnaire de fichiers du système d'exploitation et le coller.
+Remarque : à l'intérieur des gestionnaires d'événements `cut` et `copy`, un appel à `event.clipboardData.getData(...)` renvoie une chaîne vide. C'est parce que techniquement, les données ne sont pas encore dans le presse-papiers. Si nous utilisons `event.preventDefault()`, il ne sera pas du tout copié.
 
-C'est parce que `clipboardData` implémente l'interface `DataTransfer`, couramment utilisée pour glisser-déposer et copier/coller. C'est un peu au-delà de notre portée maintenant, mais vous pouvez trouver ses méthodes [dans la specification](https://html.spec.whatwg.org/multipage/dnd.html#the-datatransfer-interface).
+Ainsi, l'exemple ci-dessus utilise `document.getSelection()` pour obtenir le texte sélectionné. Vous pouvez trouver plus de détails sur la sélection de documents dans l'article <info:selection-range>.
 
-```warn header="ClipboardAPI: restrictions de sécurité des utilisateurs"
-Le presse-papiers est une chose "globale" au niveau du système d'exploitation. Ainsi, la plupart des navigateurs autorisent l'accès en lecture/écriture au presse-papiers uniquement dans le cadre de certaines actions de l'utilisateur pour la sécurité, par ex. dans les gestionnaires d'événements `onclick`.
+Il est possible de copier/coller pas seulement du texte, mais tout. Par exemple, nous pouvons copier un fichier dans le gestionnaire de fichiers du système d'exploitation et le coller.
 
-Il est également interdit de générer des événements de presse-papiers "personnalisés" avec `dispatchEvent` dans tous les navigateurs sauf Firefox.
-```
-=======
-Please note: inside `cut` and `copy` event handlers a call to  `event.clipboardData.getData(...)` returns an empty string. That's because technically the data isn't in the clipboard yet. If we use `event.preventDefault()` it won't be copied at all.
-
-So the example above uses `document.getSelection()` to get the selected text. You can find more details about document selection in the article <info:selection-range>.
-
-It's possible to copy/paste not just text, but everything. For instance, we can copy a file in the OS file manager, and paste it.
-
-That's because `clipboardData` implements `DataTransfer` interface, commonly used for drag'n'drop and copy/pasting. It's bit beyond our scope now, but you can find its methods in the [DataTransfer specification](https://html.spec.whatwg.org/multipage/dnd.html#the-datatransfer-interface).
+C'est parce que `clipboardData` implémente l'interface `DataTransfer`, couramment utilisée pour le glisser-déposer et le copier/coller. C'est un peu hors de notre portée maintenant, mais vous pouvez trouver ses méthodes dans la [spécification DataTransfer](https://html.spec.whatwg.org/multipage/dnd.html#the-datatransfer-interface).
 
-Also, there's an additional asynchronous API of accessing the clipboard: `navigator.clipboard`. More about it in the specification [Clipboard API and events](https://www.w3.org/TR/clipboard-apis/), [not supported by Firefox](https://caniuse.com/async-clipboard).
+En outre, il existe une API asynchrone supplémentaire pour accéder au presse-papiers : `navigator.clipboard`. Plus d'informations à ce sujet dans la spécification [Clipboard API and events](https://www.w3.org/TR/clipboard-apis/), [non pris en charge par Firefox](https://caniuse.com/async-clipboard).
 
-### Safety restrictions
+### Restrictions de sécurité
 
-The clipboard is a "global" OS-level thing. A user may switch between various applications, copy/paste different things, and a browser page shouldn't see all that.
+Le presse-papiers est une chose "globale" au niveau du système d'exploitation. Un utilisateur peut basculer entre différentes applications, copier/coller différentes choses, et une page de navigateur ne devrait pas voir tout cela.
 
-So most browsers allow seamless read/write access to the clipboard only in the scope of certain user actions, such as copying/pasting etc.
+Ainsi, la plupart des navigateurs permettent un accès en lecture/écriture transparent au presse-papiers uniquement dans le cadre de certaines actions de l'utilisateur, telles que le copier/coller, etc.
 
-It's forbidden to generate "custom" clipboard events with `dispatchEvent` in all browsers except Firefox. And even if we manage to dispatch such event, the specification clearly states that such "syntetic" events must not provide access to the clipboard.
+Il est interdit de générer des événements de presse-papiers "personnalisés" avec `dispatchEvent` dans tous les navigateurs sauf Firefox. Et même si nous parvenons à envoyer un tel événement, la spécification indique clairement que de tels événements "synthétiques" ne doivent pas donner accès au presse-papiers.
 
-Even if someone decides to save `event.clipboardData` in an event handler, and then access it later -- it won't work.
+Même si quelqu'un décide d'enregistrer `event.clipboardData` dans un gestionnaire d'événements, puis d'y accéder plus tard, cela ne fonctionnera pas.
 
-To reiterate, [event.clipboardData](https://www.w3.org/TR/clipboard-apis/#clipboardevent-clipboarddata) works solely in the context of user-initiated event handlers.
+Pour réitérer, [event.clipboardData](https://www.w3.org/TR/clipboard-apis/#clipboardevent-clipboarddata) fonctionne uniquement dans le contexte des gestionnaires d'événements initiés par l'utilisateur.
 
-On the other hand, [navigator.clipboard](https://www.w3.org/TR/clipboard-apis/#h-navigator-clipboard) is the more recent API, meant for use in any context. It asks for user permission, if needed. Not supported in Firefox.
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
+D'autre part, [navigator.clipboard](https://www.w3.org/TR/clipboard-apis/#h-navigator-clipboard) est l'API la plus récente, destinée à être utilisée dans n'importe quel contexte. Il demande l'autorisation de l'utilisateur, si nécessaire. Non pris en charge dans Firefox.
 
 ## Récapitulatif
 
 Événements de changement de données:
 
 | Événement | Description | Specials |
 |---------|----------|-------------|
-<<<<<<< HEAD
-| `change`| Une valeur a été modifiée | Se déclenche à la perte du focus pour les champs textes. |
+| `change`| Une valeur a été modifiée | Pour les entrées de texte, les déclencheurs sont sur la perte de mise au point. |
 | `input` | Pour les champs textes à chaque modification. | Se déclenche immédiatement contrairement à `change`. |
-| `cut/copy/paste` | Les actions couper/copier/coller. | L'action peut être empêchée. La propiété `event.clipboardData` donne un accès en lecture/écriture au presse-papiers. |
-=======
-| `change`| A value was changed. | For text inputs triggers on focus loss. |
-| `input` | For text inputs on every change. | Triggers immediately unlike `change`. |
-| `cut/copy/paste` | Cut/copy/paste actions. | The action can be prevented. The `event.clipboardData` property gives access to the clipboard. All browsers except Firefox also support `navigator.clipboard`. |
->>>>>>> eda333d423db8ade41f75d2e2d30ea06c7d997ef
+| `cut/copy/paste` | Les actions couper/copier/coller. | L'action peut être empêchée. La propiété `event.clipboardData` donne un accès en lecture/écriture au presse-papiers. Tous les navigateurs, à l'exception de Firefox, prennent également en charge `navigator.clipboard`. |