diff options
Diffstat (limited to 'files/fr/web/javascript/reference/operators/equality/index.md')
| -rw-r--r-- | files/fr/web/javascript/reference/operators/equality/index.md | 116 |
1 files changed, 54 insertions, 62 deletions
diff --git a/files/fr/web/javascript/reference/operators/equality/index.md b/files/fr/web/javascript/reference/operators/equality/index.md index 0668aa74d4..5598ca09d6 100644 --- a/files/fr/web/javascript/reference/operators/equality/index.md +++ b/files/fr/web/javascript/reference/operators/equality/index.md @@ -7,57 +7,51 @@ tags: - Operator - Reference browser-compat: javascript.operators.equality -translation-of: Web/JavaScript/Reference/Operators/Equality --- -<div>{{jsSidebar("Operators")}}</div> +{{jsSidebar("Operators")}} -<p>L'opérateur d'égalité (<code>==</code>) vérifie si ses deux opérandes sont égaux et renvoie un booléen indiquant le résultat de la comparaison. À la différence de l'opérateur <a href="/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality">d'égalité stricte</a>, l'opérateur d'égalité tente de convertir ses opérandes avant la comparaison si ceux-ci sont de types différents.</p> +L'opérateur d'égalité (`==`) vérifie si ses deux opérandes sont égaux et renvoie un booléen indiquant le résultat de la comparaison. À la différence de l'opérateur [d'égalité stricte](/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality), l'opérateur d'égalité tente de convertir ses opérandes avant la comparaison si ceux-ci sont de types différents. -<div>{{EmbedInteractiveExample("pages/js/expressions-equality.html")}}</div> +{{EmbedInteractiveExample("pages/js/expressions-equality.html")}} -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js x == y -</pre> - -<h2 id="description">Description</h2> - -<p>Les opérateurs d'égalité (<code>==</code> et <code>!=</code>) utilisent <a href="https://www.ecma-international.org/ecma-262/5.1/#sec-11.9.3">l'algorithme de comparaison d'égalité abstraite</a> pour comparer deux opérandes. On peut le résumer ainsi :</p> - -<ul> - <li>Si les opérandes sont deux objets, on renvoie <code>true</code> uniquement si les deux opérandes référencent le même objet.</li> - <li>Si un opérande vaut <code>null</code> et que l'autre vaut <code>undefined</code>, on renvoie <code>true</code>.</li> - <li>Si les opérandes sont de types différents, on tente une conversion pour avoir le même type de part et d'autre avant la comparaison : - <ul> - <li>Si on compare un nombre à une chaîne de caractères, on tentera de convertir la chaîne en une valeur numérique.</li> - <li>Si l'un des opérandes est un booléen, on le convertira en 1 s'il vaut <code>true</code> et en +0 s'il vaut <code>false</code>.</li> - <li>Si l'un des opérandes est un objet et que l'autre est un nombre ou une chaîne de caractères, on tentera de convertir l'objet en une valeur primitive grâce aux méthodes <code>valueOf()</code> et <code>toString()</code> de l'objet.</li> - </ul> - </li> - <li>Si les opérandes sont du même types, on les compare comme suit : - <ul> - <li><code>String</code> : on renvoie <code>true</code> uniquement si les deux opérandes ont les mêmes caractères dans le même ordre.</li> - <li><code>Number</code> : on renvoie <code>true</code> uniquement si les deux opérandes ont la même valeur. <code>+0</code> et <code>-0</code> sont considérés comme la même valeur. Si au moins un des opérandes vaut <code>NaN</code>, on renvoie <code>false</code>.</li> - <li><code>Boolean</code> : on renvoie <code>true</code> uniquement si les deux opérandes valent tous les deux <code>true</code> ou s'ils valent tous les deux <code>false</code>.</li> - </ul> - </li> -</ul> - -<p>La différence fondamentale entre cet opérateur et <a href="/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality">l'opérateur d'égalité stricte</a> (<code>===</code>) est que ce dernier n'opère pas de conversion de type. L'opérateur d'égalité stricte considère toujours que deux valeurs de types différents sont différentes.</p> - -<h2 id="examples">Exemples</h2> - -<h3 id="comparison_with_no_type_conversion">Comparaison sans conversion de types</h3> - -<pre class="brush: js"> +``` + +## Description + +Les opérateurs d'égalité (`==` et `!=`) utilisent [l'algorithme de comparaison d'égalité abstraite](https://www.ecma-international.org/ecma-262/5.1/#sec-11.9.3) pour comparer deux opérandes. On peut le résumer ainsi : + +- Si les opérandes sont deux objets, on renvoie `true` uniquement si les deux opérandes référencent le même objet. +- Si un opérande vaut `null` et que l'autre vaut `undefined`, on renvoie `true`. +- Si les opérandes sont de types différents, on tente une conversion pour avoir le même type de part et d'autre avant la comparaison : + + - Si on compare un nombre à une chaîne de caractères, on tentera de convertir la chaîne en une valeur numérique. + - Si l'un des opérandes est un booléen, on le convertira en 1 s'il vaut `true` et en +0 s'il vaut `false`. + - Si l'un des opérandes est un objet et que l'autre est un nombre ou une chaîne de caractères, on tentera de convertir l'objet en une valeur primitive grâce aux méthodes `valueOf()` et `toString()` de l'objet. + +- Si les opérandes sont du même types, on les compare comme suit : + + - `String` : on renvoie `true` uniquement si les deux opérandes ont les mêmes caractères dans le même ordre. + - `Number` : on renvoie `true` uniquement si les deux opérandes ont la même valeur. `+0` et `-0` sont considérés comme la même valeur. Si au moins un des opérandes vaut `NaN`, on renvoie `false`. + - `Boolean` : on renvoie `true` uniquement si les deux opérandes valent tous les deux `true` ou s'ils valent tous les deux `false`. + +La différence fondamentale entre cet opérateur et [l'opérateur d'égalité stricte](/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality) (`===`) est que ce dernier n'opère pas de conversion de type. L'opérateur d'égalité stricte considère toujours que deux valeurs de types différents sont différentes. + +## Exemples + +### Comparaison sans conversion de types + +```js 1 == 1; // true "coucou" == "coucou"; // true -</pre> +``` -<h3 id="comparison_with_type_conversion">Comparaison avec conversion de types</h3> +### Comparaison avec conversion de types -<pre class="brush: js"> +```js "1" == 1; // true 1 == "1"; // true 0 == false; // true @@ -71,23 +65,23 @@ const nombre1 = new Number(3); const nombre2 = new Number(3); nombre1 == 3; // true nombre1 == nombre2; // false -</pre> +``` -<h3 id="comparison_of_objects">Comparaison d'objets</h3> +### Comparaison d'objets -<pre class="brush: js"> +```js const objet1 = {"clé": "valeur"} const objet2 = {"clé": "valeur"}; objet1 == objet2 // false objet2 == objet2 // true -</pre> +``` -<h3 id="comparing_strings_and_string_objects">Comparaison entre des chaînes de caractères et des objets String</h3> +### Comparaison entre des chaînes de caractères et des objets String -<p>On notera que les chaînes de caractères construites avec <code>new String()</code> sont des objets. Si on compare une telle valeur avec une chaîne de caractères "primitives", l'objet <code>String</code> sera converti en une chaîne de caractères et les contenus de ces chaînes seront comparés. Toutefois, si les deux opérandes sont des objets <code>String</code>, ils seront comparés comme tels et devront référencer le même objet pour être considérés égaux :</p> +On notera que les chaînes de caractères construites avec `new String()` sont des objets. Si on compare une telle valeur avec une chaîne de caractères "primitives", l'objet `String` sera converti en une chaîne de caractères et les contenus de ces chaînes seront comparés. Toutefois, si les deux opérandes sont des objets `String`, ils seront comparés comme tels et devront référencer le même objet pour être considérés égaux : -<pre class="brush: js"> +```js const string1 = "coucou"; const string2 = String("coucou"); const string3 = new String("coucou"); @@ -98,28 +92,26 @@ console.log(string1 == string3); // true console.log(string2 == string3); // true console.log(string3 == string4); // false console.log(string4 == string4); // true -</pre> +``` -<h3 id="comparing_dates_and_strings">Comparaison entre les dates et les chaînes de caractères</h3> +### Comparaison entre les dates et les chaînes de caractères -<pre class="brush: js"> +```js const d = new Date('December 17, 1995 03:24:00'); const s = d.toString(); // par exemple : "Sun Dec 17 1995 03:24:00 GMT-0800 (Pacific Standard Time)" console.log(d == s); //true -</pre> +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/JavaScript/Reference/Operators/Inequality">L'opérateur d'inégalité</a></li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality">L'opérateur d'égalité stricte</a></li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Operators/Strict_inequality">L'opérateur d'inégalité stricte</a></li> -</ul> +- [L'opérateur d'inégalité](/fr/docs/Web/JavaScript/Reference/Operators/Inequality) +- [L'opérateur d'égalité stricte](/fr/docs/Web/JavaScript/Reference/Operators/Strict_equality) +- [L'opérateur d'inégalité stricte](/fr/docs/Web/JavaScript/Reference/Operators/Strict_inequality) |