Merge branch 'master' into master

Author: rztprog

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

@@ -6,7 +6,7 @@ Voyons ce qui est spécial à propos de JavaScript, ce qu'il nous permet de fair
 
 *JavaScript* a été initiallement créé pour *"rendre les pages web vivantes"*.
 
-Les programmes dans ce langage sont appelés *scripts*. Ils peuvent être écrits directement dans le code HTML et exécutés automatiquement au chargement des pages.
+Les programmes dans ce langage sont appelés *scripts*. Ils peuvent être écrits directement dans une page HTML et exécutés automatiquement au chargement des pages.
 
 Les scripts sont fournis et exécutés en texte brut. Ils n'ont pas besoin d'une préparation spéciale ou d'une compilation pour fonctionner.
 
@@ -70,9 +70,9 @@ Les exemples de telles restrictions sont:
 
     Il existe des moyens d’interagir avec une webcam / microphone et d’autres appareils, mais ils nécessitent une autorisation explicite de l’utilisateur. Ainsi, une page compatible avec JavaScript ne permet pas d'activer une caméra Web, d'observer l'environnement et d'envoyer les informations à la [NSA](https://fr.wikipedia.org/wiki/National_Security_Agency).
 
-- Différents onglets / fenêtres ne se connaissent généralement pas. Parfois, ils se croisent, par exemple lorsqu'une fenêtre utilise JavaScript pour ouvrir l'autre. Mais même dans ce cas, le JavaScript d'une page ne peut pas accéder à l'autre s'il provient de sites différents (provenant d'un autre domaine, protocole ou port).
+- Différents onglets / fenêtres ne se connaissent généralement pas. Parfois, ils se croisent, par exemple lorsqu'une fenêtre utilise JavaScript pour ouvrir l'autre. Mais même dans ce cas, le JavaScript d'une page ne peut pas accéder à l'autre si elle provient de sites différents (provenant d'un autre domaine, protocole ou port).
 
-    C'est ce qu'on appelle la "politique de même origine"(“Same Origin Policy”). Pour contourner cette sécurité, *les deux pages* doivent contenir un code JavaScript spécial qui gère l'échange de données.
+    C'est ce qu'on appelle la "politique de même origine" (“Same Origin Policy”). Pour contourner cette sécurité, *les deux pages* doivent se mettre d'accord et contenir un code JavaScript spécial qui gère l'échange de données. Nous allons voir cela plus loin dans ce tutoriel.
 
     Cette limitation concerne également la sécurité de l'utilisateur. Une page de `http://autresite.com` qu'un utilisateur a ouverte ne doit pas pouvoir accéder à un autre onglet du navigateur avec l'URL `http://gmail.com` et y voler des informations.
 
@@ -109,13 +109,14 @@ Donc, récemment, une pléthore de nouveaux langages sont apparus, qui sont *tra
 
 Les outils modernes rendent la [transpilation](https://fr.wiktionary.org/wiki/transpilation) très rapide et transparente, permettant aux développeurs de coder dans une autre langue et de la convertir automatiquement "sous le capot".
 
-Exemples de ce genre de langages :
+Les exemples les plus courants de ce genre de langages :
 
 - [CoffeeScript](http://coffeescript.org/) est un "sucre syntaxique" pour JavaScript, il introduit une syntaxe plus courte, permettant d’écrire du code plus précis et plus clair. Habituellement, les développeurs Ruby l'aiment bien.
 - [TypeScript](http://www.typescriptlang.org/) se concentre sur l'ajout de "typage strict des données" pour simplifier le développement et la prise en charge de systèmes complexes. Il est développé par Microsoft.
+- [Flow](http://flow.org/) ajoute également la saisie de données, mais de manière différente. Développé par Facebook.
 - [Dart](https://www.dartlang.org/) est un langage autonome doté de son propre moteur qui s'exécute dans des environnements autres que les navigateurs (comme les applications mobiles). Il était initialement proposé par Google en remplacement de JavaScript, mais pour le moment, les navigateurs exigent qu’il soit transposé en JavaScript, tout comme ceux ci-dessus.
 
-Il y en a plus. Bien sûr, même si nous utilisons un de ces langages, nous devrions également connaître le langage JavaScript, pour bien comprendre ce que nous faisons.
+Il en existe évidemment bien plus, cela dit, même si nous utilisons un de ces langages, nous devrions également connaître le langage JavaScript, pour bien comprendre ce que nous faisons.
 
 ## Résumé
 

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

@@ -0,0 +1,43 @@
+
+# Manuels et spécifications
+
+Ce livre est un *tutoriel*. Il vise à vous aider à apprendre progressivement le langage. Mais une fois que vous maîtriserez les bases, vous aurez besoin d’autres ressources.
+
+
+## Spécification
+
+**La spécification ECMA-262** contient les informations les plus détaillées et formalisées sur JavaScript. C'est elle qui définit le langage.
+
+Mais cela étant formalisé, elle est difficile à comprendre au début. Si vous avez besoin de la source d’informations la plus fiable sur les détails du langage, c’est le bon endroit. Mais ce n’est pas très pratique pour un usage quotidien.
+
+La dernière version de la spécification est disponible à cette adresse : <https://tc39.es/ecma262/>.
+
+Pour en savoir plus sur les fonctionnalités à venir, vous pouvez consulter les propositions à cette adresse : <https://github.com/tc39/proposals>.
+
+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.
+
+## Manuels
+
+- **La référence MDN (Mozilla) JavaScript** est un manuel avec des exemples et d’autres informations. C’est une excellente source pour obtenir des informations détaillées sur les fonctions linguistiques, les méthodes, etc.
+
+    On peut la trouver à cette adresse : <https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference>.
+
+  Cependant, il est souvent préférable d’utiliser une recherche sur Internet. Utilisez simplement "MDN [terme]" dans la requête, par exemple <https://google.com/search?q=MDN+parseInt> pour rechercher la fonction `parseInt`.
+
+
+- **MSDN** – Manuel Microsoft contenant de nombreuses informations, y compris sur JavaScript (souvent appelé JScript). Si vous avez besoin de quelque chose de spécifique à Internet Explorer, c'est l'endroit qu'il vous faut : <http://msdn.microsoft.com/>.
+
+    Nous pouvons également utiliser une recherche sur Internet avec des expressions telles que "RegExp MSDN" ou encore "RegExp MSDN jscript".
+
+## Support des fonctionnalités
+
+JavaScript est un langage en développement, de nouvelles fonctionnalités sont ajoutées régulièrement.
+
+Pour voir si elles sont supportées dans les moteurs, au sein des navigateurs et autres, voir :
+
+- <http://caniuse.com> - tables de prise en charge par fonctionnalité, par exemple pour voir quels moteurs supportent les fonctions de cryptographie modernes : <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - un tableau avec les fonctionnalités linguistiques et les moteurs qui les prennent en charge ou non.
+
+Toutes ces ressources sont utiles dans le quotidien des développeurs, parce qu'elles contiennent des informations précieuses sur les fonctionnalités du langage, leur support, etc.
+
+Veuillez vous en souvenir (ou de cette page) pour les cas où vous avez besoin d'informations détaillées sur une fonctionnalité particulière.

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

@@ -8,15 +8,14 @@ Il existe deux archétypes: IDE et les éditeurs légers. Beaucoup de personnes
 
 Le terme [IDE](https://fr.wikipedia.org/wiki/Environnement_de_développement) (Integrated Development Environment) signifie un éditeur puissant avec de nombreuses fonctionnalités qui fonctionne généralement sur un "projet entier". Comme son nom l’indique, ce n’est pas seulement un éditeur, mais un environnement de développement complet.
 
-Un IDE charge le projet (peut contenir de nombreux fichiers), permet la navigation entre les fichiers, fournit une auto-complétion basée sur l'ensemble du projet (pas seulement le fichier ouvert), s'intègre à un système de gestion de version (comme git), un environnement de test et d’autres éléments au niveau du projet.
+Un IDE charge le projet (peut contenir de nombreux fichiers), permet la navigation entre les fichiers, fournit une auto-complétion basée sur l'ensemble du projet (pas seulement le fichier ouvert), s'intègre à un système de gestion de version (comme [git](https://git-scm.com/)), un environnement de test et d’autres éléments au niveau du projet.
 
 Si vous n'avez pas encore pensé à sélectionner un IDE, examinez les variantes suivantes :
 
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
 - [WebStorm](http://www.jetbrains.com/webstorm/) pour le développement frontend et autres éditeurs de la même société si vous avez besoin de langues supplémentaires.
-- Visual Studio convient parfaitement si vous êtes un développeur .NET, une version gratuite est disponible ([Visual Studio Community](https://www.visualstudio.com/vs/community/))
-- [Netbeans](http://netbeans.org/).
 
-Tous les IDE, à l'exception de Visual Studio, sont disponibles sous Windows, MacOs et Linux. Visual Studio ne fonctionne pas sous Linux.
+Pour Windows, il existe également "Visual Studio", à ne pas confondre avec "Visual Studio Code ". "Visual Studio" est un éditeur payant et puissant, uniquement conçu pour Windows, bien adapté à la plate-forme .NET. C’est aussi bon en JavaScript. Il y a aussi une version gratuite [Visual Studio Community](https://www.visualstudio.com/vs/community/).
 
 La plupart des IDE sont payants, mais ont une période d'essai. Leur coût est généralement négligeable par rapport au salaire d’un développeur qualifié, alors choisissez le meilleur pour vous.
 
@@ -32,24 +31,16 @@ En pratique, les éditeurs légers peuvent avoir beaucoup de plug-ins, y compris
 
 Les options suivantes méritent votre attention :
 
-- [Visual Studio Code](https://code.visualstudio.com/) (multiplateforme, gratuit).
 - [Atom](https://atom.io/) (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.
 
-## Mes favoris
 
-La préférence personnelle de l'auteur est d'avoir à la fois un IDE pour les projets et un éditeur léger pour l'édition rapide et facile des fichiers.
-
-J'utilise :
-
-- [WebStorm](http://www.jetbrains.com/webstorm/) pour JS, et s'il y a une autre langue dans le projet, je passe alors à l'une des autres offres Jetbrains répertoriées ci-dessus.
-- En tant qu'éditeur léger -- [Sublime Text](http://www.sublimetext.com) et [Atom](https://atom.io/).
 
 ## Ne discutons pas
 
-Les éditeurs des listes ci-dessus sont ceux que mes amis ou moi-même, que je considère comme de bons développeurs, utilisent depuis longtemps et en sont satisfaits.
+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.
 
 Il y a d'autres grands éditeurs dans notre vaste monde. Veuillez choisir celui que vous aimez le plus.
 

1-js/01-getting-started/3-devtools/article.md renamed to 1-js/01-getting-started/4-devtools/article.md

@@ -50,20 +50,18 @@ Ouvrez les préférences et accédez au volet "Avancé". Il y a une case à coch
 
 Maintenant `key:Cmd+Opt+C` peut activer la console. Notez également que le nouvel élément de menu supérieur nommé "Développement" est apparu. Il a beaucoup de commandes et d'options.
 
+## Entrée multiligne
+
+Habituellement, lorsque nous insérons une ligne de code dans la console, puis que nous appuyons sur Entrée, la procédure s’exécute.
+
+Pour insérer plusieurs lignes, appuyez sur `key:Shift+Enter`.
+
+
+
 ## Résumé
 
 - Les outils de développement nous permettent de voir les erreurs, d'exécuter des commandes, d'examiner des variables et bien plus encore.
 - Ils peuvent être ouverts avec `key:F12` pour la plupart des navigateurs sous Windows. Chrome pour Mac necessite la combinaison `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (doit être activé avant).
 
-<<<<<<< HEAD
-Nous avons maintenant notre environnement prêt. Dans la section suivante, nous passerons à JavaScript.
-=======
-To insert multiple lines, press `key:Shift+Enter`.
-
-## Summary
 
-- Developer tools allow us to see errors, run commands, examine variables, and much more.
-- They can be opened with `key:F12` for most browsers on Windows. Chrome for Mac needs `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (need to enable first).
-
-Now we have the environment ready. In the next section, we'll get down to JavaScript.
->>>>>>> 19223ae762f03cdff4e83f6f963f4f427af93847
+Nous avons maintenant notre environnement prêt. Dans la section suivante, nous passerons à JavaScript.

1-js/01-getting-started/3-devtools/bug.html renamed to 1-js/01-getting-started/4-devtools/bug.html

@@ -1,18 +1,10 @@
 # Hello, world!
 
-<<<<<<< HEAD
-Le tutoriel que vous êtes en train de lire est à propos du coeur de JavaScript, qui est indépendant des plateformes de développement. Plus loins, vous allez apprendre Node.JS qui est une plateforme qui l'utilise.
+Le tutoriel que vous êtes en train de lire est à propos du coeur de JavaScript, le langage lui même. Plus loins, vous allez apprendre Node.JS qui est une plateforme qui l'utilise.
 
 Mais nous avons besoin d'un environnement de travail pour exécuter nos scripts et, étant donné que ce guide est en ligne, le navigateur est un bon choix. Nous allons nous efforcer d'utiliser les commandes spécifiques au navigateur (comme `alert`) au minimum afin de ne pas y consacrer du temps si vous prévoyez de vous concentrer sur un autre environnement tel que Node.JS. Par ailleurs, les détails du navigateur sont expliqués dans [la partie suivante](/ui) du didacticiel.
 
 Alors, voyons d'abord comment intégrer un script à une page Web. Pour les environnements côté serveur, vous pouvez simplement l'exécuter avec une commande comme `"node mon.js"` pour Node.JS.
-=======
-The tutorial that you're reading is about core JavaScript, which is platform-independent. Later on, you'll learn about Node.js and other platforms that use it.
-
-But we need a working environment to run our scripts and, since this book is online, the browser is a good choice. We'll keep the amount of browser-specific commands (like `alert`) to a minimum so that you don't spend time on them if you plan to concentrate on another environment (like Node.js). We'll focus on JavaScript in the browser in the [next part](/ui) of the tutorial.
-
-So first, let's see how we attach a script to a webpage. For server-side environments (like Node.js), you can execute the script with a command like `"node my.js"`.
->>>>>>> 19223ae762f03cdff4e83f6f963f4f427af93847
 
 
 ## La balise "script" 
@@ -27,15 +19,15 @@ Par exemple :
 
 <body>
 
-  <p>Avant le script ...</p>
+  <p>Before the script...</p>
 
 *!*
   <script>
     alert( 'Hello, world!' );
   </script>
 */!*
 
-  <p>... Après le script.</p>
+  <p>...After the script.</p>
 
 </body>
 
@@ -55,7 +47,7 @@ La balise `<script>` a quelques attributs qui sont rarement utilisés de nos jou
 
  L'attribut `type` : <code>&lt;script <u>type</u>=...&gt;</code>
 
- : L'ancien standard HTML4 nécessitait pour un script d'avoir un type. En général, il s'agissait de `type = "text / javascript"`. Il n’est plus nécessaire. En outre, la norme moderne a totalement changé la signification de cet attribut. Maintenant, il peut être utilisé pour les modules Javascript. Mais c’est un sujet avancé, mais nous parlerons des modules plus tard dans une autre partie du tutoriel.
+ : L'ancien standard HTML4 nécessitait pour un script d'avoir un `type`. En général, il s'agissait de `type = "text / javascript"`. Dorénavant il n’est plus nécessaire. En outre, le standard moderne HTML5 a totalement changé la signification de cet attribut. Maintenant, il peut être utilisé pour les modules Javascript. Mais c’est un sujet avancé, nous parlerons des modules plus tard dans une autre partie du tutoriel.
 
  L'attribut `language` : <code>&lt;script <u>language</u>=...&gt;</code>
 : Cet attribut était destiné à afficher la langue du script. Pour l'instant, cet attribut n'a aucun sens, le langage est le JavaScript par défaut. Pas besoin de l'utiliser.

1-js/01-getting-started/3-devtools/chrome.png renamed to 1-js/01-getting-started/4-devtools/chrome.png

@@ -52,15 +52,23 @@ Pour l’avenir, lorsque vous utilisez une console de navigation pour tester des
 
 Parfois, lorsque `use strict` fait une différence, vous obtenez des résultats incorrects.
 
-Même si nous appuyons sur la touche `key:Shift+Entrée` pour saisir plusieurs lignes et que `use strict` est placé en haut, cela ne fonctionne pas. Cela est dû à la manière dont la console exécute le code en interne.
+Vous pouvez essayer d'appuyer sur `key:Shift+Enter` pour saisir plusieurs lignes et mettre `use strict` en haut comme cela :
 
-Le moyen fiable pour vous assurer d'utiliser `use strict` serait de saisir le code dans la console de la manière suivante :
+```js
+'use strict'; <Shift+Enter for a newline>
+//  ...votre code
+<Enter to run>
+```
+
+Cela fonctionne dans la plupart des navigateurs, à savoir Firefox et Chrome.
+
+Si ce n’est pas le cas, le moyen le plus fiable d’assurer `use strict` serait d'entrer le code dans la console comme ceci :
 
 ```js
 (function() {
   'use strict';
 
-  // ...your code...
+  // ...votre code...
 })()
 ```
 
@@ -75,4 +83,4 @@ Dans les chapitres suivants, au fur et à mesure que nous apprendrons les foncti
 1. La directive `"use strict"` fait passer le moteur en mode "moderne", modifiant le comportement de certaines fonctionnalités intégrées. Nous les verrons en détails pendant que nous étudions.
 2. Le mode strict est activé par `"use strict"` en haut du fichier. Il existe également plusieurs fonctionnalités de langage telles que "classes" et "modules" qui permettent un mode strict automatiquement.
 3. Le mode strict est pris en charge par tous les navigateurs modernes.
-4. Il est toujours recommandé de lancer les scripts avec `"use strict"`. Tous les exemples de ce tutoriel le supposent, sauf si (très rarement) c'est spécifié autrement.
+4. Il est toujours recommandé de lancer les scripts avec `"use strict"`. Tous les exemples de ce tutoriel le supposent, sauf si (très rarement) c'est spécifié autrement.