Constructeur Boolean()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Le constructeur Boolean() permet de créer des objets Boolean.
Exemple interactif
const flag = new Boolean();
console.log(typeof flag);
// Sortie attendue : object
console.log(flag === false);
// Sortie attendue : false
const flag2 = Boolean();
console.log(typeof flag2);
// Sortie attendue : boolean
console.log(flag2 === false);
// Sortie attendue : true
Syntaxe
new Boolean(value)
Boolean(value)
Note :
Boolean() peut être appelé avec ou sans new, mais avec des effets différents. Voir Valeur de retour.
Paramètres
value-
La valeur initiale de l'objet
Boolean.
Valeur de retour
Lorsque Boolean() est appelé comme une fonction (sans new), il retourne value converti en valeur primitive booléenne.
Lorsque Boolean() est appelé comme constructeur (avec new), il convertit value en valeur primitive booléenne et retourne un objet Boolean enveloppant, qui n'est pas une valeur primitive.
Attention :
Vous ne devriez presque jamais utiliser Boolean comme constructeur.
Description
La valeur passée en premier paramètre est convertie en valeur booléenne. Si la valeur est omise ou vaut 0, -0, 0n, null, false, NaN, undefined, ou la chaîne vide (""), alors l'objet a une valeur initiale de false. Toutes les autres valeurs, y compris n'importe quel objet, un tableau vide ([]) ou la chaîne "false", créent un objet avec une valeur initiale de true.
Note :
Lorsque la propriété non standard document.all est utilisée comme argument pour ce constructeur, le résultat est un objet Boolean avec la valeur false. Cette propriété est historique et non standard et ne doit pas être utilisée.
Exemples
Créer des objets Boolean avec une valeur initiale à false
const bPasDeParam = new Boolean();
const bZero = new Boolean(0);
const bNull = new Boolean(null);
const bChaineVide = new Boolean("");
const bFalse = new Boolean(false);
Créer des objets Boolean avec une valeur initiale à true
const bTrue = new Boolean(true);
const bChaineTrue = new Boolean("true");
const bChaineFalse = new Boolean("false");
const bSuLin = new Boolean("Su Lin");
const bArrayProto = new Boolean([]);
const bObjProto = new Boolean({});
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-boolean-constructor |
Compatibilité des navigateurs
Voir aussi
- L'entrée de glossaire Booléen