Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Boolean : méthode toString()

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

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

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

js
toString()

Paramètres

Aucun.

Valeur de retour

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

Description

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"

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-boolean.prototype.tostring

Compatibilité des navigateurs

Voir aussi