25


Boolean
L'objet Boolean correspond à l'encapsulation d'une valeur booléenne.
Syntaxe
new Boolean(valeur)
Paramètres
valeur 

Valeur initiale de l'objet de type Boolean.
Description
La valeur ou variable est convertie en valeur booléenne si nécessaire. Si elle n'est pas fournie ou prend l'une des valeurs suivantes : 0, -0, null, false, NaN, undefined ou une chaîne vide (""), l'objet prend la valeur initiale false. Pour toutes les autres valeurs, y compris les objets ou même la chaîne "false", l'objet prendra la valeur initiale true.
Les valeurs booléennes primitives true et false ne doivent pas être confondues avec les valeurs d'un objet de type Boolean.
Tout objet dont la valeur n'est pas null ou undefined, même un objet Boolean dont la valeur est false, sera évalué comme true dans une expression conditionnelle. Par exemple, dans la condition suivante, la variable x sera évaluée à true même si l'objet possède quant à lui la valeur false.
x = new Boolean(false);
if (x) {
  . . . // ce code est exécuté
}
Ce n'est pas le cas si on utilise une valeur booléenne primitive. Par exemple, l'évaluation suivante renverra la valeur false.
x = false;
if (x) {
  . . . // ce code n'est pas exécuté
}
Il n'est pas conseillé d'instancier un objet de la classe Boolean pour convertir une expression non-booléenne en valeur booléenne. Utilisez plutôt la fonction Boolean elle même pour transtyper l'expression désirée.
x = Boolean(expression);     // recommandé
x = new Boolean(expression); // à ne pas utiliser
Rappelons que l'instanciation d'un objet Boolean à l'aide d'un autre objet, y compris un autre objet de type Boolean dont la valeur serait false, produira toujours un objet avec une valeur initiale à true.
myFalse = new Boolean(false);   // valeur initiale : false
g = new Boolean(myFalse);       // valeur initiale : true
myString = new String("Hello"); // objet chaîne
s = new Boolean(myString);      //valeur initiale : true
Bref, en un mot comme en cent, n'utilisez pas un objet Boolean à la place d'une valeur booléenne primitive.
Propriétés
Pour les propriétés héritées par les instances de Boolean consultez Propriétés des instances de Boolean.
prototype : Définit une propriété partagée par tous les objets Boolean.
Propriétés héritées de Function.prototype
caller, constructor, length, name

Méthodes
Pour les méthodes héritées par les instances de Boolean consultez Méthodes des instances de Boolean.
L'objet global Boolean ne contient aucune méthode de lui-même, mais hérite de certaines méthodes au travers de la chaîne de prototypes.
Méthodes héritées de Function.prototype
apply, call, toSource, toString, valueOf
Méthodes héritées de Object.prototype
__defineGetter__, __defineSetter__, hasOwnProperty, isPrototypeOf, __lookupGetter__, __lookupSetter__, __noSuchMethod__, propertyIsEnumerable, unwatch, watch

Instances de Boolean
Les instances de </div>Boolean</code> héritent de R%C3%A9f%C3%A9rence_de_JavaScript_1.5_Core:Objets_globaux:Boolean:prototypeBoolean.prototype. L'objet prototype du constructeur peut être utilisé pour ajouter des propriétés ou des méthodes à toutes les instances de <code>Boolean. === Propriétés ===
constructor
Renvoie la fonction de création d'un prototype d'instance. Il s'agit de la fonction Boolean par défaut.
=== Méthodes ===
toSource
Renvoie une chaîne contenant le code source de l'objet Boolean ; celle-ci peut être utilisée pour créer un objet équivalent. Remplace la méthode Object.prototype.toSource.
toString
Renvoie une chaîne contenant soir « true » soit « false » selon la valeur de l'objet. Remplace la méthode Object.prototype.toString.
valueOf
Renvoie la valeur primitive de l'objet Boolean. Remplace la méthode Object.prototype.valueOf.
Méthodes héritées de Object.prototype
__defineGetter__, __defineSetter__, hasOwnProperty, isPrototypeOf, __lookupGetter__, __lookupSetter__, __noSuchMethod__, propertyIsEnumerable, unwatch, watch

Exemples
Création d'objets Boolean avec une valeur initiale de false
bNoParam = new Boolean();
bZero = new Boolean(0);
bNull = new Boolean(null);
bEmptyString = new Boolean("");
bfalse = new Boolean(false);
Création d'objets Boolean avec une valeur initiale de true
btrue = new Boolean(true);
btrueString = new Boolean("true");
bfalseString = new Boolean("false");
bSuLin = new Boolean("Su Lin");