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 --- .../equality_comparisons_and_sameness/index.html | 344 ++++++++++----------- 1 file changed, 157 insertions(+), 187 deletions(-) (limited to 'files/fr/web/javascript/equality_comparisons_and_sameness') diff --git a/files/fr/web/javascript/equality_comparisons_and_sameness/index.html b/files/fr/web/javascript/equality_comparisons_and_sameness/index.html index 50aeff4d0c..d61690d512 100644 --- a/files/fr/web/javascript/equality_comparisons_and_sameness/index.html +++ b/files/fr/web/javascript/equality_comparisons_and_sameness/index.html @@ -51,7 +51,7 @@ original_slug: Web/JavaScript/Les_différents_tests_d_égalité

On notera que pour ces trois opérations, la comparaison s'effectue sur les valeurs des éléments qu'on compare, aucune de ces opérations ne permet de comparer la structure des paramètres. Pour des objets non primitifs, x et y qui ont la même structure mais qui sont des objets distincs, chacune des opérations présentées ci-avant sera évaluée à false.

-

L'égalité stricte avec ===

+

L'égalité stricte avec ===

L'égalité stricte compare deux valeurs et teste leur égalité. Aucune des valeurs n'est convertie implicitement en une autre valeur avant que la comparaison soit effectuée. Si les valeurs sont typées différemment, elles sont considérées comme différentes. Si les valeurs sont de même type et ne sont pas des nombres, elles sont considérées égales si elles ont la même valeur. Si les deux valeurs sont des nombres, elles sont égales si elles ont la même valeur et que cette valeur n'est pas NaN ou si l'une vaut +0 et l'autre -0.

@@ -73,7 +73,7 @@ console.log(obj === undefined); // false

Ce test d'égalité stricte est presque toujours la meilleure des opérations à considérer pour ces tests. Excepté pour les nombres, la sémantique utilisée est simple : une valeur est uniquement égale à elle-même. En ce qui concerne les nombres, il y a deux cas aux limites à considérer. Le premier cas concerne le nombre zéro positif ou négatif. Cela peut être utile dans la représentation de problèmes mathématiques mais ne constitue pas une différence pour de nombreuses situations : le test d'égalité stricte considère que ce sont les mêmes valeurs. Le second cas concerne la valeur « n'est pas un nombre », NaN (pour « not a number » en anglais) permettant de représenter certaines entités mathématiques : la somme des deux infinis (positif et négatif) par exemple. Le test d'égalité stricte considère que NaN est différent de toutes les valeurs, y compris lui-même. (N.B. : Le seul cas de figure pour lequel on a (x !== x) qui renvoie true est lorsque x vaut NaN.)

-

L'égalité faible avec ==

+

L'égalité faible avec ==

Le test d'égalité faible compare deux valeurs après les avoir converties en valeurs d'un même type. Une fois converties (la conversion peut s'effectuer pour l'une ou les deux valeurs), la comparaison finale est la même que celle effectuée par ===. L'égalité faible est symétrique : A == B aura toujours la même signification que B == A pour toute valeur de A et B.

@@ -83,74 +83,74 @@ console.log(obj === undefined); // false - Opérande B + Opérande B - Undefined - Null - Number - String - Boolean - Object + Undefined + Null + Number + String + Boolean + Object Opérande A Undefined - true - true - false - false - false - false + true + true + false + false + false + false Null - true - true - false - false - false - false + true + true + false + false + false + false Number - false - false - A === B - A === ToNumber(B) - A === ToNumber(B) - A == ToPrimitive(B) + false + false + A === B + A === ToNumber(B) + A === ToNumber(B) + A == ToPrimitive(B) String - false - false - ToNumber(A) === B - A === B - ToNumber(A) === ToNumber(B) - A == ToPrimitive(B) + false + false + ToNumber(A) === B + A === B + ToNumber(A) === ToNumber(B) + A == ToPrimitive(B) Boolean - false - false - ToNumber(A) === B - ToNumber(A) === ToNumber(B) - A === B - false + false + false + ToNumber(A) === B + ToNumber(A) === ToNumber(B) + A === B + false Object - false - false - ToPrimitive(A) == B - ToPrimitive(A) == B - ToPrimitive(A) == ToNumber(B) - + false + false + ToPrimitive(A) == B + ToPrimitive(A) == B + ToPrimitive(A) == ToNumber(B) +

A === B

@@ -182,7 +182,7 @@ console.log(obj == undefined);

Certains développeurs considèrent que ce n'est jamais une bonne idée d'utiliser l'égalilté faible. Le résultat d'une comparaison utilisant l'égalité stricte est plus simple à appréhender et à prédire, de plus il n'y a aucune conversion implicite ce qui rend le test plus rapide.

-

Égalité de valeurs

+

Égalité de valeurs

L'égalité de valeurs répond à un dernier cas d'utilisation : savoir si deux valeurs sont fonctionnellement identiques pour tout contexte. (Ce cas d'utilisation est un exemple du principe de substitution de Liskov). On retrouve ce cas lorsqu'on essaie de changer une propriété immuable :

@@ -199,7 +199,7 @@ function attemptMutation(v) {

L'égalité de valeurs peut être testée grâce à la méthode {{jsxref("Object.is")}}.

-

Égalité de valeurs nulles

+

Égalité de valeurs nulles

On utilise la même égalité que l'égalité de valeur et on considère que +0 et -0 sont égaux.

@@ -215,218 +215,218 @@ function attemptMutation(v) {

Cependant, ce « modèle de pensées » ne peut pas être étendu avec l'arrivée d'{{jsxref("Object.is")}} avec ES6 (ECMAScript 2015). En effet Object.is() n'est pas plus « faible » que l'égalité faible ou plus « stricte » que l'égalité stricte et il n'est pas non plus quelque part entre les deux. Dans le tableau de comparaison ci-après, on voit que la différence provient avant tout de la façon dont {{jsxref("Object.is")}} gère {{jsxref("NaN")}}. On note ici que si Object.is(NaN, NaN) valait false, on pourrait dire qu'Object.is() est plus stricte que == ou === car elle distingue -0 et +0. Cependant, ce n'est pas le cas et on a bien Object.is(NaN,NaN) qui vaut true. C'est pour cette raison qu'il faut considérer {{jsxref("Object.is")}} selon ses caractéristiques spécifiques plutôt que comme une version plus faible ou plus stricte des autres opérateurs d'égalité.

- +
- - - - - - + + + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + +
Comparaisons d'égalité
xy=====Object.isSameValueZeroxy=====Object.isSameValueZero
undefined undefinedtruetruetruetruetruetruetruetrue
null nulltruetruetruetruetruetruetruetrue
true truetruetruetruetruetruetruetruetrue
false falsetruetruetruetruetruetruetruetrue
'toto' 'toto'truetruetruetruetruetruetruetrue
0 0truetruetruetruetruetruetruetrue
+0 -0truetruefalsetruetruetruefalsetrue
+0 0truetruetruetruetruetruetruetrue
-0 0truetruefalsetruetruetruefalsetrue
0 falsetruefalsefalsefalsetruefalsefalsefalse
"" falsetruefalsefalsefalsetruefalsefalsefalse
"" 0truefalsefalsefalsetruefalsefalsefalse
'0' 0truefalsefalsefalsetruefalsefalsefalse
'17' 17truefalsefalsefalsetruefalsefalsefalse
[1, 2] '1,2'truefalsefalsefalsetruefalsefalsefalse
new String('toto') 'toto'truefalsefalsefalsetruefalsefalsefalse
null undefinedtruefalsefalsefalsetruefalsefalsefalse
null falsefalsefalsefalsefalsefalsefalsefalsefalse
undefined falsefalsefalsefalsefalsefalsefalsefalsefalse
{ toto: 'truc' } { toto: 'truc' }falsefalsefalsefalsefalsefalsefalsefalse
new String('toto') new String('toto')falsefalsefalsefalsefalsefalsefalsefalse
0 nullfalsefalsefalsefalsefalsefalsefalsefalse
0 NaNfalsefalsefalsefalsefalsefalsefalsefalse
'toto' NaNfalsefalsefalsefalsefalsefalsefalsefalse
NaN NaNfalsefalsetruetruefalsefalsetruetrue
@@ -439,46 +439,16 @@ function attemptMutation(v) {
- (négation unaire)
-
- -

Si on prend l'opposé de 0, on aura, bien entendu,-0. Cependant, avec les expressions, cela peut faire que la valeur -0 se glisse dans les variables sans qu'on s'en rende compte. Par exemple :

- 
let forceArrêt = obj.masse * -obj.vitesse
-

Si obj.vitesse vaut 0 (ou est évalué à 0), un -0 sera introduit, ce qui fera que forceArrêt pourra être négative.

-
- -
-
{{jsxref("Math.atan2")}}
- {{jsxref("Math.ceil")}}
- {{jsxref("Math.pow")}}
- {{jsxref("Math.round")}}
-
- -
+
{{jsxref("Math.atan2")}}, {{jsxref("Math.ceil")}}, {{jsxref("Math.pow")}}, {{jsxref("Math.round")}}
Ces méthodes peuvent introduire -0 dans une expression lors de leur évaluation, même si -0 ne faisait pas partie des paramètres. Par exemple, si on utilise Math.pow() pour élever {{jsxref("Infinity", "-Infinity")}} à une puissance négative, on obtiendra -0 pour une puissance impaire. Pour plus de détails, voir la documentation de chaque méthode.
-
- -
-
{{jsxref("Math.floor")}}
- {{jsxref("Math.max")}}
- {{jsxref("Math.min")}}
- {{jsxref("Math.sin")}}
- {{jsxref("Math.sqrt")}}
- {{jsxref("Math.tan")}}
-
- -
+
{{jsxref("Math.floor")}}, {{jsxref("Math.max")}}, {{jsxref("Math.min")}}, {{jsxref("Math.sin")}}, {{jsxref("Math.sqrt")}}, {{jsxref("Math.tan")}}
Ces méthodes peuvent renvoyer -0 dans certains cas où -0 est passé en paramètre. Par exemple, Math.min(-0, +0) fournira -0. Pour plus de détails, voir la documentation de chaque méthode.
-
- -
-
~
-
<<
-
>>
+
~, <<, >>
Chacun de ces opérateurs utilise l'algorithme ToInt32 interne au moteur JavaScript. Étant donné qu'il n'y a qu'une seule représentation pour 0 sur les entiers exprimés avec le type interne sur 32 bits, -0 ne sera pas invariant pour deux opérations symétriques : Object.is(~~(-0), -0) et Object.is(-0 << 2 >> 2, -0) renverront tous les deux false.
-- cgit v1.2.3-54-g00ecf