Boolean : méthode toString()

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.

La méthode toString() des valeurs Boolean retourne une chaîne de caractères représentant la valeur booléenne spécifiée.

Dans cet article

Exemple interactif

const flag1 = new Boolean(true);

console.log(flag1.toString());
// Sortie attendue : "true"

const flag2 = new Boolean(1);

console.log(flag2.toString());
// Sortie attendue : "true"

Syntaxe

toString()

Valeur de retour

Une chaîne de caractères qui représente l'objet Boolean.

L'objet Boolean surcharge la méthode toString de Object ; il n'hérite pas de Object.prototype.toString(). Pour les valeurs de type Boolean, la méthode toString retourne une représentation sous forme de chaîne de caractères de la valeur booléenne, qui est soit "true" soit "false".

La méthode toString() exige que sa valeur this soit une valeur primitive ou un objet enveloppe Boolean. Elle lève une exception TypeError pour d'autres valeurs de this sans tenter de les convertir en booléen.

Parce que Boolean ne possède pas de méthode [Symbol.toPrimitive](), JavaScript appelle automatiquement la méthode toString() lorsqu'un objet Boolean est utilisé dans un contexte où une chaîne de caractères est attendue, comme dans un littéral de gabarit. Cependant, les valeurs primitives booléennes n'utilisent pas la méthode toString() pour être converties en chaînes de caractères — elles sont directement converties en utilisant le même algorithme que l'implémentation initiale de toString().

js
Boolean.prototype.toString = () => "Surchargé";
console.log(`${true}`); // "true"
console.log(`${new Boolean(true)}`); // "Surchargé"

Exemples

Utiliser toString()

Dans ce code, flag.toString() retourne "true" :

js
const flag = new Boolean(true);
console.log(flag.toString()); // "true"
console.log(false.toString()); // "false"

La méthode Object.prototype.toString()

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

Boolean : méthode toString()

Dans cet article

Exemple interactif

Syntaxe

Paramètres

Valeur de retour

Description

Exemples

Utiliser toString()

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN