From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/boolean/index.md | 165 +++++++++------------ .../global_objects/boolean/tosource/index.md | 51 +++---- .../global_objects/boolean/tostring/index.md | 92 +++++------- .../global_objects/boolean/valueof/index.md | 88 ++++------- 4 files changed, 160 insertions(+), 236 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/boolean') diff --git a/files/fr/web/javascript/reference/global_objects/boolean/index.md b/files/fr/web/javascript/reference/global_objects/boolean/index.md index abfa0c874d..970556573d 100644 --- a/files/fr/web/javascript/reference/global_objects/boolean/index.md +++ b/files/fr/web/javascript/reference/global_objects/boolean/index.md @@ -9,30 +9,29 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Boolean original_slug: Web/JavaScript/Reference/Objets_globaux/Boolean --- -
{{JSRef}}
+{{JSRef}} -

L'objet Boolean est un objet permettant de représenter une valeur booléenne.

+L'objet **`Boolean`** est un objet permettant de représenter une valeur booléenne. -

Syntaxe

+## Syntaxe -
new Boolean([valeur])
+ new Boolean([valeur]) -

Paramètres

+## Paramètres -
-
valeur{{optional_inline}}
-
Paramètre optionnel, la valeur initiale de l'objet Boolean.
-
+- `valeur`{{optional_inline}} + - : Paramètre optionnel, la valeur initiale de l'objet `Boolean`. -

Description

+## Description -

La valeur passée en premier paramètre est, si nécessaire, convertie en valeur booléenne. Si la valeur est omise ou est 0, -0, {{jsxref("null")}}, false, {{jsxref("NaN")}}, {{jsxref("undefined")}} ou une chaine de caractères vide (""), l'objet a un valeur initiale à false (faux). Si l'objet DOM {{domxref("document.all")}} est passé en argument, la valeur initiale sera également false. Toutes les autres valeurs, y compris n'importe quel objet, un tableau vide ([]), ou une chaine de caractères "false", créént un objet avec une valeur initiale à true (vrai).

+La valeur passée en premier paramètre est, si nécessaire, convertie en valeur booléenne. Si la valeur est omise ou est `0`, `-0`, {{jsxref("null")}}, `false`, {{jsxref("NaN")}}, {{jsxref("undefined")}} ou une chaine de caractères vide (""), l'objet a un valeur initiale à `false` (faux). Si l'objet DOM {{domxref("document.all")}} est passé en argument, la valeur initiale sera également `false`. Toutes les autres valeurs, y compris n'importe quel objet, un tableau vide (`[]`), ou une chaine de caractères `"false"`, créént un objet avec une valeur initiale à `true` (vrai). -

Ne pas confondre les valeurs primitives booléennes true et false avec les valeurs true et false d'un objet Booléen.

+Ne pas confondre les valeurs primitives booléennes `true` et `false` avec les valeurs _true_ et _false_ d'un objet Booléen. -

Tout objet dont la valeur n'est ni  undefined ni null, incluant un objet Booléen dont la valeur est fausse, évalue à true lorsqu'il est à une instruction conditionnelle. Par exemple, la condition (voir {{jsxref("Instructions/if...else", "if")}}), dans le code suivant, est validée si l'expression est évaluée à true :

+Tout objet dont la valeur n'est ni  `undefined` ni `null`, incluant un objet Booléen dont la valeur est fausse, évalue à `true` lorsqu'il est à une instruction conditionnelle. Par exemple, la condition (voir {{jsxref("Instructions/if...else", "if")}}), dans le code suivant, est validée si l'expression est évaluée à `true` : -
var x = new Boolean("false");
+```js
+var x = new Boolean("false");
 if (x) {
   // . . . le code est exécuté
 }
@@ -41,123 +40,99 @@ var y = new Boolean(false);
 if (y) {
   // ce code est également exécuté
 }
-
+``` -

Ce comportement ne s'applique pas aux valeurs primitives booléennes. Par exemple, la condition, dans le code suivant, est évaluée à false :

+Ce comportement ne s'applique pas aux valeurs primitives booléennes. Par exemple, la condition, dans le code suivant, est évaluée à `false` : -
var x = false;
+```js
+var x = false;
 if (x) {
   // . . . le code n'est pas exécuté
 }
-
+``` -

Ne pas utiliser un objet Boolean pour convertir une valeur non-booléenne en une valeur booléenne. Utilisez plutot une fonction booléenne pour effectuer cette tâche :

+Ne pas utiliser un objet `Boolean` pour convertir une valeur non-booléenne en une valeur booléenne. Utilisez plutot une fonction booléenne pour effectuer cette tâche : -
var x = Boolean(expression);     // conseillé
+```js
+var x = Boolean(expression);     // conseillé
 var y = new Boolean(expression); // à ne pas utiliser
-
+``` -

Si vous spécifiez un objet quelconque, incluant un objet booléen qui a une valeur fausse, le nouvel objet Boolean a une valeur vraie.

+Si vous spécifiez un objet quelconque, incluant un objet booléen qui a une valeur fausse, le nouvel objet `Boolean` a une valeur vraie. -
var myFalse = new Boolean(false);   // valeur initiale à false
+```js
+var myFalse = new Boolean(false);   // valeur initiale à false
 var g = Boolean(myFalse);       // valeur initiale à true
 var myString = new String("Hello"); // un object String
 var s = Boolean(myString);      // valeur initiale à true
-
+``` -

Ne pas utiliser un objet Booléen à la place d'une valeur primitive booléenne.

+Ne pas utiliser un objet Booléen à la place d'une valeur primitive booléenne. -
-

Note : Lorsque la propriété historique, non-standard, document.all est utilisée comme argument, le constructeur Boolean renvoie un objet booléen faux. Cette propriété étant non-standard, son utilisation est déconseillée.

-
+> **Note :** Lorsque la propriété historique, non-standard, [`document.all`](/fr/docs/Web/API/Document#Properties) est utilisée comme argument, le constructeur `Boolean` renvoie un objet booléen faux. Cette propriété étant non-standard, son utilisation est déconseillée. -

Propriétés

+## Propriétés -
-
Boolean.length
-
Renvoie 1. Le nombre d'arguments pris en charge par le constructeur.
-
{{jsxref("Boolean.prototype")}}
-
Représente le prototype du constructeur Boolean.
-
+- `Boolean.length` + - : Renvoie 1. Le nombre d'arguments pris en charge par le constructeur. +- {{jsxref("Boolean.prototype")}} + - : Représente le prototype du constructeur `Boolean`. -

Méthodes

+## Méthodes -

L'objet global Boolean ne contient pas ses propres méthodes, cependant, il hérite de certaines méthodes à travers la chaine de prototypes.

+L'objet global `Boolean` ne contient pas ses propres méthodes, cependant, il hérite de certaines méthodes à travers la chaine de prototypes. -

Instances de Boolean

+## Instances de `Boolean` -

Toutes les Boolean héritent de {{jsxref("Boolean.prototype")}}. Comme avec tous les constructeurs, l'objet prototype dicte les propriétés et les méthodes héritées par les instances.

+Toutes les `Boolean` héritent de {{jsxref("Boolean.prototype")}}. Comme avec tous les constructeurs, l'objet prototype dicte les propriétés et les méthodes héritées par les instances. -

Propriétés

+### Propriétés -

{{page('fr/docs/JavaScript/Reference/Objets_globaux/Boolean/prototype','Propri.C3.A9t.C3.A9s')}}

+{{page('fr/docs/JavaScript/Reference/Objets_globaux/Boolean/prototype','Propri.C3.A9t.C3.A9s')}} -

Méthodes

+### Méthodes -

{{page('fr/docs/JavaScript/Reference/Objets_globaux/Boolean/prototype','M.C3.A9thodes')}}

+{{page('fr/docs/JavaScript/Reference/Objets_globaux/Boolean/prototype','M.C3.A9thodes')}} -

Exemples

+## Exemples -

Création d'objets Boolean avec une valeur initiale à faux

+### Création d'objets `Boolean` avec une valeur initiale à faux -
var bNoParam = new Boolean();
+```js
+var bNoParam = new Boolean();
 var bZero = new Boolean(0);
 var bNull = new Boolean(null);
 var bEmptyString = new Boolean("");
 var bfalse = new Boolean(false);
-
+``` -

Création d'objets Boolean avec une valeur initiale à vrai

+### Création d'objets `Boolean` avec une valeur initiale à vrai -
var btrue = new Boolean(true);
+```js
+var btrue = new Boolean(true);
 var btrueString = new Boolean("true");
 var bfalseString = new Boolean("false");
 var bArrayProto = new Boolean([]);
 var bObjProto = new Boolean({});
 var bSuLin = new Boolean("Su Lin");
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES1')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.6', 'Boolean')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-boolean-objects', 'Boolean')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-boolean-objects', 'Boolean')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Boolean")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.6', 'Boolean')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-boolean-objects', 'Boolean')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-boolean-objects', 'Boolean')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Boolean")}} + +## Voir aussi + +- {{jsxref("Boolean.prototype")}} +- [Les valeurs primitives en JavaScript](/fr/docs/Web/JavaScript/Structures_de_données#Les_valeurs_primitives) +- {{Glossary("Boolean","booléen")}} +- [Le type de données booléen (Wikipédia)](https://fr.wikipedia.org/wiki/Bool%C3%A9en) diff --git a/files/fr/web/javascript/reference/global_objects/boolean/tosource/index.md b/files/fr/web/javascript/reference/global_objects/boolean/tosource/index.md index c194c56ae6..df7e12c637 100644 --- a/files/fr/web/javascript/reference/global_objects/boolean/tosource/index.md +++ b/files/fr/web/javascript/reference/global_objects/boolean/tosource/index.md @@ -11,46 +11,43 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Boolean/toSource original_slug: Web/JavaScript/Reference/Objets_globaux/Boolean/toSource --- -
{{JSRef}} {{Non-standard_header}}
+{{JSRef}} {{Non-standard_header}} -

La méthode toSource() renvoie une chaine de caractères représentant le code source de l'objet.

+La méthode **`toSource()`** renvoie une chaine de caractères représentant le code source de l'objet. -

Syntaxe

+## Syntaxe -
booleanObj.toSource()
-Boolean.toSource()
+ booleanObj.toSource() + Boolean.toSource() -

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant le code source de l'objet.

+Une chaîne de caractères représentant le code source de l'objet. -

Description

+## Description -

La méthode toSource renvoie les valeurs suivantes :

+La méthode `toSource` renvoie les valeurs suivantes : - + ```js + function Boolean() { + [native code] + } + ``` -

Cette méthode est généralement utilisée de façon interne par le moteur JavaScript et n'est pas appelée explicitement dans des scripts.

+- Pour les instances de {{jsxref("Boolean")}}, `toSource` renvoie une chaîne explicitant le code source de l'objet. -

Spécifications

+Cette méthode est généralement utilisée de façon interne par le moteur JavaScript et n'est pas appelée explicitement dans des scripts. -

Ne fait partie d'aucun standard. Implémentée avec JavaScript 1.3.

+## Spécifications -

Compatibilité des navigateurs

+Ne fait partie d'aucun standard. Implémentée avec JavaScript 1.3. -

{{Compat("javascript.builtins.Boolean.toSource")}}

+## Compatibilité des navigateurs -

Voir aussi

+{{Compat("javascript.builtins.Boolean.toSource")}} - +## Voir aussi + +- {{jsxref("Object.prototype.toSource()")}} {{non-standard_inline}} diff --git a/files/fr/web/javascript/reference/global_objects/boolean/tostring/index.md b/files/fr/web/javascript/reference/global_objects/boolean/tostring/index.md index aedf9e0b00..d3c00ab270 100644 --- a/files/fr/web/javascript/reference/global_objects/boolean/tostring/index.md +++ b/files/fr/web/javascript/reference/global_objects/boolean/tostring/index.md @@ -10,76 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Boolean/toString original_slug: Web/JavaScript/Reference/Objets_globaux/Boolean/toString --- -
{{JSRef}}
+{{JSRef}} -

La méthode toString() renvoie une chaine de caractères correspondant à l'objet Boolean courant.

+La méthode **`toString()`** renvoie une chaine de caractères correspondant à l'objet `Boolean` courant. -
{{EmbedInteractiveExample("pages/js/boolean-tostring.html")}}
+{{EmbedInteractiveExample("pages/js/boolean-tostring.html")}} -

Syntaxe

+## Syntaxe -
bool.toString()
+ bool.toString() -

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères qui représente l'objet {{jsxref("Boolean")}}.

+Une chaîne de caractères qui représente l'objet {{jsxref("Boolean")}}. -

Description

+## Description -

L'objet {{jsxref("Boolean")}} surcharge la méthode toString() de l'objet {{jsxref("Object")}} ; il n'hérite pas de la méthode {{jsxref("Object.prototype.toString()")}}. Pour les objets de type Boolean, la méthode toString() renvoie une chaine de caractère representative de l'objet.

+L'objet {{jsxref("Boolean")}} surcharge la méthode `toString()` de l'objet {{jsxref("Object")}} ; il n'hérite pas de la méthode {{jsxref("Object.prototype.toString()")}}. Pour les objets de type `Boolean`, la méthode `toString()` renvoie une chaine de caractère representative de l'objet. -

La méthode toString() est automatiquement appelée quand le Boolean doit être representé comme une texte ou lorsque qu'il est concaténé avec une chaine de caractères.

+La méthode `toString()` est automatiquement appelée quand le `Boolean` doit être representé comme une texte ou lorsque qu'il est concaténé avec une chaine de caractères. -

Pour les objets de type Boolean , la fonction native toString() renvoie la chaine de caractère "true" ou "false" en fonction de la valeur de l'objet.

+Pour les objets de type `Boolean` , la fonction native `toString()` renvoie la chaine de caractère "`true`" ou "`false`" en fonction de la valeur de l'objet. -

Exemples

+## Exemples -

Utiliser toString()

+### Utiliser `toString()` -

Dans ce code, flag.toString() renvoie "true" :

+Dans ce code, `flag.toString()` renvoie "`true`" : -
var flag = new Boolean(true);
+```js
+var flag = new Boolean(true);
 var maVar = flag.toString();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('ES1')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.6.4.2', 'Boolean.prototype.toString')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-boolean.prototype.tostring', 'Boolean.prototype.toString')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-boolean.prototype.tostring', 'Boolean.prototype.toString')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Boolean.toString")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.1. | +| {{SpecName('ES5.1', '#sec-15.6.4.2', 'Boolean.prototype.toString')}} | {{Spec2('ES5.1')}} |   | +| {{SpecName('ES6', '#sec-boolean.prototype.tostring', 'Boolean.prototype.toString')}} | {{Spec2('ES6')}} |   | +| {{SpecName('ESDraft', '#sec-boolean.prototype.tostring', 'Boolean.prototype.toString')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Boolean.toString")}} + +## Voir aussi + +- {{jsxref("Object.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/boolean/valueof/index.md b/files/fr/web/javascript/reference/global_objects/boolean/valueof/index.md index 336b15a0ea..78b325ede5 100644 --- a/files/fr/web/javascript/reference/global_objects/boolean/valueof/index.md +++ b/files/fr/web/javascript/reference/global_objects/boolean/valueof/index.md @@ -10,72 +10,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Boolean/valueOf original_slug: Web/JavaScript/Reference/Objets_globaux/Boolean/valueOf --- -
{{JSRef}}
+{{JSRef}} -

La méthode valueOf() renvoie la valeur primitive de l'objet {{jsxref("Boolean")}}.

+La méthode **`valueOf()`** renvoie la valeur primitive de l'objet {{jsxref("Boolean")}}. -
{{EmbedInteractiveExample("pages/js/boolean-valueof.html")}}
+{{EmbedInteractiveExample("pages/js/boolean-valueof.html")}} -

Syntaxe

+## Syntaxe -
bool.valueOf()
+ bool.valueOf() -

Valeur de retour

+### Valeur de retour -

La valeur primitive associée à l'objet {{jsxref("Boolean")}}.

+La valeur primitive associée à l'objet {{jsxref("Boolean")}}. -

Description

+## Description -

La méthode valueOf() de {{jsxref("Boolean")}} renvoie la valeur primitive d'un objet Boolean, ou d'un littéral booléen.

+La méthode `valueOf()` de {{jsxref("Boolean")}} renvoie la valeur primitive d'un objet `Boolean`, ou d'un littéral booléen. -

Cette méthode est généralement utilisée de façon interne pas le moteur JavaScript et n'est pas utilisée explicitement dans les scripts.

+Cette méthode est généralement utilisée de façon interne pas le moteur JavaScript et n'est pas utilisée explicitement dans les scripts. -

Exemples

+## Exemples -

Utiliser valueOf()

+### Utiliser `valueOf()` -
var x = new Boolean();
+```js
+var x = new Boolean();
 var maVar = x.valueOf()      // assigne false à maVar
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES1')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.6.4.3', 'Boolean.prototype.valueOf')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-boolean.prototype.valueof', 'Boolean.prototype.valueOf')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-boolean.prototype.valueof', 'Boolean.prototype.valueOf')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Boolean.valueOf")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.1. | +| {{SpecName('ES5.1', '#sec-15.6.4.3', 'Boolean.prototype.valueOf')}} | {{Spec2('ES5.1')}} |   | +| {{SpecName('ES6', '#sec-boolean.prototype.valueof', 'Boolean.prototype.valueOf')}} | {{Spec2('ES6')}} |   | +| {{SpecName('ESDraft', '#sec-boolean.prototype.valueof', 'Boolean.prototype.valueOf')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Boolean.valueOf")}} + +## Voir aussi + +- {{jsxref("Object.prototype.valueOf()")}} -- cgit v1.2.3-54-g00ecf