From 2a76c37d0e733dedf8ed87d1e7e46caf3c44667e Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Fri, 30 Jul 2021 20:18:17 +0200 Subject: Prepare JS French section for Markdown (#1574) * Rm IDs w/ [^h\d] id=" * Remove class="hidden" * Remove hidden for code blocks * rm summary classes * Use Note consistently * Remove sup * Rm code in pre * Fixes dd/dt/dl * Fix some more dd * Remove inline style and useless/craft from span/font * h2m report fixing - Consistent use of notes * h2m report fixing - Consistent use of warnings * h2m report fixing - reword one callout * h2m report fixing - array cruft spans hell * Cleaning the rest of docs for md conversion --- .../functions/arguments/callee/index.html | 2 +- .../reference/functions/arguments/index.html | 8 ++++---- .../reference/functions/arrow_functions/index.html | 2 +- .../functions/default_parameters/index.html | 2 +- .../javascript/reference/functions/get/index.html | 6 ++---- .../web/javascript/reference/functions/index.html | 24 ---------------------- .../functions/method_definitions/index.html | 6 ++---- .../reference/functions/rest_parameters/index.html | 2 -- .../javascript/reference/functions/set/index.html | 5 ----- 9 files changed, 11 insertions(+), 46 deletions(-) (limited to 'files/fr/web/javascript/reference/functions') diff --git a/files/fr/web/javascript/reference/functions/arguments/callee/index.html b/files/fr/web/javascript/reference/functions/arguments/callee/index.html index 67425dc6f2..4f69ce4490 100644 --- a/files/fr/web/javascript/reference/functions/arguments/callee/index.html +++ b/files/fr/web/javascript/reference/functions/arguments/callee/index.html @@ -19,7 +19,7 @@ original_slug: Web/JavaScript/Reference/Fonctions/arguments/callee

callee est une propriété de l'objet arguments. Elle peut être utilisée afin de faire référence à la fonction en cours d'exécution à l'intérieur de cette fonction. Cette propriété peut etre utile lorsqu'on ne connait pas le nom de la fonction (fonction anonyme par exemple).

-
Attention : En mode strict, ECMAScript 5 interdit la fonction arguments.callee(). Éviter de l'utiliser en utilisant un nom de fonction dans les expressions ou en utilisant une déclaration de fonction où la fonction s'appelle elle-même.
+

Attention : En mode strict, ECMAScript 5 interdit la fonction arguments.callee(). Éviter de l'utiliser en utilisant un nom de fonction dans les expressions ou en utilisant une déclaration de fonction où la fonction s'appelle elle-même.

Pourquoi arguments.callee a-t-il été retiré du mode strict ES5 ?

diff --git a/files/fr/web/javascript/reference/functions/arguments/index.html b/files/fr/web/javascript/reference/functions/arguments/index.html index c5dcf10c83..b47df19565 100644 --- a/files/fr/web/javascript/reference/functions/arguments/index.html +++ b/files/fr/web/javascript/reference/functions/arguments/index.html @@ -24,10 +24,10 @@ original_slug: Web/JavaScript/Reference/Fonctions/arguments
{{EmbedInteractiveExample("pages/js/functions-arguments.html")}}
- -
-

Note du traducteur : « Variable ayant la fonction pour portée » correspond à la traduction de « Variable of the function scope » qu'il serait incorrect de traduire par « Variable de la portée de la fonction » car la portée de la fonction est la portée dans laquelle on peut appeler la fonction. Une variable locale de la fonction pourrait quant à elle avoir une portée strictement incluse dans le corps de la fonction (variable définie dans un bloc de la fonction même si cette subtilité n'existe pas en Javascript). Toute suggestion pour éviter cette tournure un peu longue sans altérer le sens est la bienvenue. (variable intrinsèque)

+ +
+

Remarque : « Variable ayant la fonction pour portée » correspond à la traduction de « Variable of the function scope » qu'il serait incorrect de traduire par « Variable de la portée de la fonction » car la portée de la fonction est la portée dans laquelle on peut appeler la fonction. Une variable locale de la fonction pourrait quant à elle avoir une portée strictement incluse dans le corps de la fonction (variable définie dans un bloc de la fonction même si cette subtilité n'existe pas en Javascript). Toute suggestion pour éviter cette tournure un peu longue sans altérer le sens est la bienvenue. (variable intrinsèque)

Syntaxe

@@ -67,7 +67,7 @@ var args = Array.from(arguments); var args = [...arguments];
-

Important : Il est déconseillé d'utiliser slice sur les arguments car cela peut empêcher certaines optimisations des moteurs JavaScript. Pour ce scénario, on peut par exemple construire un nouveau tableau en parcourant l'objet arguments (à ce sujet, voir cette page sur les contraintes d'optimisations liées à V8). Pour cet exemple, on pourra utiliser Array.apply :

+

Attention : Il est déconseillé d'utiliser slice sur les arguments car cela peut empêcher certaines optimisations des moteurs JavaScript. Pour ce scénario, on peut par exemple construire un nouveau tableau en parcourant l'objet arguments (à ce sujet, voir cette page sur les contraintes d'optimisations liées à V8). Pour cet exemple, on pourra utiliser Array.apply :

var args = (arguments.length === 1 ? [arguments[0]] : Array.apply(null, arguments));
diff --git a/files/fr/web/javascript/reference/functions/arrow_functions/index.html b/files/fr/web/javascript/reference/functions/arrow_functions/index.html index a956e7e39b..8beaaa3098 100644 --- a/files/fr/web/javascript/reference/functions/arrow_functions/index.html +++ b/files/fr/web/javascript/reference/functions/arrow_functions/index.html @@ -61,7 +61,7 @@ f();

Deux facteurs sont à l’origine de la conception des fonctions fléchées : une syntaxe plus courte et l’absence de this spécifique à la fonction. Sur ce dernier point, cela signifie qu’une fonction fléchée ne lie pas son propre {{jsxref("Opérateurs/L_opérateur_this","this")}} au sein de la fonction (il en va de même avec {{jsxref("Fonctions/arguments","arguments")}}, {{jsxref("Opérateurs/super","super")}} ou {{jsxref("Opérateurs/new.target","new.target")}}).

-

Voir aussi l’article sur les fonctions fléchées présent sur https://tech.mozfr.org/post/2015/06/10/ES6-en-details-%3A-les-fonctions-flechees (l’article original en anglais est disponible ici).

+

Note : Voir aussi l’article sur les fonctions fléchées présent sur https://tech.mozfr.org/post/2015/06/10/ES6-en-details-%3A-les-fonctions-flechees (l’article original en anglais est disponible ici).

Syntaxe plus courte

diff --git a/files/fr/web/javascript/reference/functions/default_parameters/index.html b/files/fr/web/javascript/reference/functions/default_parameters/index.html index 3adc4c34a4..abcdcae567 100644 --- a/files/fr/web/javascript/reference/functions/default_parameters/index.html +++ b/files/fr/web/javascript/reference/functions/default_parameters/index.html @@ -13,7 +13,7 @@ original_slug: Web/JavaScript/Reference/Fonctions/Valeurs_par_défaut_des_argume

Cette syntaxe permet d'initialiser des paramètres lors de l'appel de la fonction si aucune valeur n'est passée ou si c'est la valeur {{jsxref("undefined")}} qui est passée.

- +
{{EmbedInteractiveExample("pages/js/functions-default.html")}}
diff --git a/files/fr/web/javascript/reference/functions/get/index.html b/files/fr/web/javascript/reference/functions/get/index.html index ad265fcadc..b999d2d36a 100644 --- a/files/fr/web/javascript/reference/functions/get/index.html +++ b/files/fr/web/javascript/reference/functions/get/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Fonctions/get
{{EmbedInteractiveExample("pages/js/functions-getter.html")}}
- -

Syntaxe

{get prop() { ... } }
@@ -52,7 +50,7 @@ original_slug: Web/JavaScript/Reference/Fonctions/get
 
 
Ce code va créer une pseudo-propriété dernier de l'objet o qui va retourner la dernière entrée du tableau o.journal :

 
-
var o = {
+
var o = {
   get dernier() {
     if (this.journal.length > 0) {
       return this.journal[this.journal.length - 1];
@@ -70,7 +68,7 @@ console.log(o.dernier); // "actu"
 
 
Supprimer un accesseur avec l'opérateur delete

 
-
delete o.dernier;
+
delete o.dernier;
 

 
 
Définir un accesseur sur des objets existants grâce à defineProperty

diff --git a/files/fr/web/javascript/reference/functions/index.html b/files/fr/web/javascript/reference/functions/index.html
index 3645a760a4..ff649c6f7e 100644
--- a/files/fr/web/javascript/reference/functions/index.html
+++ b/files/fr/web/javascript/reference/functions/index.html
@@ -72,14 +72,8 @@ original_slug: Web/JavaScript/Reference/Fonctions
 

  
nom

  
Le nom de la fonction.

-

-
-

  
param

  
Le nom d'un argument à passer à la fonction (une fonction pouvant avoir jusqu'à 255 arguments).

-

-
-

  
instructions

  
Les instructions qui forment le corps de la fonction.

 

@@ -96,9 +90,6 @@ original_slug: Web/JavaScript/Reference/Fonctions
 

  
nom

  
Le nom de la fonction. Il est facultatif, auquel cas la fonction devient une fonction anonyme.

-

-
-

  
param

  
Le nom d'un argument à passer à la fonction.

  
instructions

@@ -141,14 +132,8 @@ original_slug: Web/JavaScript/Reference/Fonctions
 

  
nom

  
Le nom de la fonction.

-

-
-

  
param

  
Le nom d'un argument à passer à la fonction.

-

-
-

  
instructions

  
Les instructions qui forment le corps de la fonction.

 

@@ -164,9 +149,6 @@ original_slug: Web/JavaScript/Reference/Fonctions
 

  
nom

  
Le nom de la fonction. Ce paramètre peut être omis, auquel cas la fonction sera une fonction anonyme.

-

-
-

  
param

  
Le nom d'un argument à passer à la fonction.

  
instructions

@@ -205,9 +187,6 @@ param => expression
 

  
arg1, arg2, ... argN

  
Plusieurs (zéro ou plus) noms qui seront utilisés par la fonction comme noms d'arguments formels. Chaque nom doit être une chaîne de caractères valide au sens d'un identifiant JavaScript ou alors être une liste de telles chaînes séparées par des virgules. On aura les exemples suivants : "x", "laValeur", ou "a,b".

-

-
-

  
corpsDeLaFonction

  
Une chaîne de caractères contenant les instructions JavaScript définissant la fonction.

 

@@ -231,9 +210,6 @@ param => expression
 

  
arg1, arg2, ... argN

  
Plusieurs (zéro ou plus) noms qui seront utilisés par la fonction comme noms d'arguments formels. Chaque nom doit être une chaîne de caractères valide au sens d'un identifiant JavaScript ou alors être une liste de telles chaînes séparées par des virgules. On aura les exemples suivants : "x", "theValue", ou "a,b".

-

-
-

  
corpsFonction

  
Une chaîne de caractères contenant les instructions JavaScript définissant la fonction.

 

diff --git a/files/fr/web/javascript/reference/functions/method_definitions/index.html b/files/fr/web/javascript/reference/functions/method_definitions/index.html
index c8991b325a..13c6fdf0fa 100644
--- a/files/fr/web/javascript/reference/functions/method_definitions/index.html
+++ b/files/fr/web/javascript/reference/functions/method_definitions/index.html
@@ -17,8 +17,6 @@ original_slug: Web/JavaScript/Reference/Fonctions/Définition_de_méthode
 
 
{{EmbedInteractiveExample("pages/js/functions-definitions.html")}}

 
-
-
 
Syntaxe

 
 
var obj = {
@@ -157,7 +155,7 @@ new obj.g; // TypeError: obj.g is not a constructuer (changé avec ES2016)
 
 
Cas de test

 
-
var obj = {
+
var obj = {
   a : "toto",
   b(){ return this.a; }
 };
@@ -168,7 +166,7 @@ console.log(obj.b()); // "toto"
 
 
Cette notation raccourcie peut également être utilisée avec des noms de propriétés calculés.

 
-
var bar = {
+
var bar = {
   toto0 : function (){return 0;},
   toto1(){return 1;},
   ["toto" + 2](){return 2;},
diff --git a/files/fr/web/javascript/reference/functions/rest_parameters/index.html b/files/fr/web/javascript/reference/functions/rest_parameters/index.html
index 27d2f23377..90984a9267 100644
--- a/files/fr/web/javascript/reference/functions/rest_parameters/index.html
+++ b/files/fr/web/javascript/reference/functions/rest_parameters/index.html
@@ -15,8 +15,6 @@ original_slug: Web/JavaScript/Reference/Fonctions/paramètres_du_reste
 
 
{{EmbedInteractiveExample("pages/js/functions-restparameters.html")}}

 
-
-
 
Syntaxe

 
 
function f(a, b, ...lesArguments) {
diff --git a/files/fr/web/javascript/reference/functions/set/index.html b/files/fr/web/javascript/reference/functions/set/index.html
index e237e80627..2e7778875e 100644
--- a/files/fr/web/javascript/reference/functions/set/index.html
+++ b/files/fr/web/javascript/reference/functions/set/index.html
@@ -15,8 +15,6 @@ original_slug: Web/JavaScript/Reference/Fonctions/set
 
 
{{EmbedInteractiveExample("pages/js/functions-setter.html")}}

 
-
-
 
Syntaxe

 
 
{set prop(val) { . . .}}
@@ -27,9 +25,6 @@ original_slug: Web/JavaScript/Reference/Fonctions/set
 

  
prop

  
Le nom de la propriété à lier à la fonction.

-

-
-

  
val

  
Un alias pour la variable qui contient la valeur qu'on souhaiterait affecter à prop.

  
expression

-- 
cgit v1.2.3-54-g00ecf