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é
}

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

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 pas ses propres méthodes, cependant, il hérite de certaines méthodes à travers la chaine de prototype.

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

Spécification Statut Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Boolean' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Boolean' dans cette spécification.
Standard  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) 6.0 (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

Dernière mise à jour par : SphinxKnight,