Constructeur Boolean()

Baseline Large disponibilité

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.

Dans cet article

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

js
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.

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

js
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

js
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({});

L'entrée de glossaire Booléen

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 16 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Boolean
Constructeur
1. Boolean()
Méthodes d'instance
1. toString()
2. valueOf()
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor