Boolean

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

Syntaxe

new Boolean([valeur])

Paramètres

valeur

Paramètre optionnel, la valeur initiale de l'objet Boolean.

Description

La valeur passée premier paramètre est, si nécessaire, convertie en valeur booléenne. Si la valeur est omise ou est 0, -0, null, false, NaN, undefined ou une chaine de caractères vide (""), l'objet a un valeur initiale à false (faux). Toutes les autres valeurs, y compris un objet 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.

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 if), dans le code suivant, est validée si l'expression est évaluée à true :

var x = new Boolean("false");
if (x) {
  // . . . le code est exécuté
}

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 :

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 :

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.

var myFalse = new Boolean(false);   // valeur initiale à false
var g = new Boolean(myFalse);       // valeur initiale à true
var myString = new String("Hello"); // un object String
var s = new Boolean(myString);      // valeur initiale à true

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

Propriétés

Boolean.length

Renvoie 1. Le nombre d'arguments pris en charge par le constructeur.

Boolean.prototype

Représente le prototype du constructeur Boolean.

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.

Instances de Boolean

Toutes les Boolean héritent de 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

Méthodes

Exemples

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

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

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

Compatibilité des navigateurs

Voir aussi

• Boolean.prototype
• Les valeurs primitives en JavaScript
• booléen
• Le type de données booléen (Wikipédia)