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). Si l'objet DOM document.all est passé en argument, la valeur initiale sera également false. 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 = 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.

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.

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 = Boolean();
var bZero = Boolean(0);
var bNull = Boolean(null);
var bEmptyString = Boolean("");
var bfalse = Boolean(false);

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

var btrue = Boolean(true);
var btrueString = Boolean("true");
var bfalseString = Boolean("false");
var bArrayProto = Boolean([]);
var bObjProto = Boolean({});
var bSuLin = Boolean("Su Lin");

Spécifications

Spécification État 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  
ECMAScript Latest Draft (ECMA-262)
La définition de 'Boolean' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui
prototypeChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui
toSource
Non-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Support complet 1IE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonEdge Mobile Aucun support NonFirefox Android Support complet 4Opera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Nonnodejs Aucun support Non
toStringChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui
valueOfChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.

Voir aussi

Étiquettes et contributeurs liés au document

Dernière mise à jour par : SphinxKnight,