Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Symbol.toStringTag — une étiquette d’objet personnalisée

Symbol.toStringTag est un symbole bien connu utilisé comme clé de propriété pour fournir l’étiquette affichée par Object.prototype.toString(). Il modifie la description d’un objet, et non son type réel.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);

Symbol.toStringTag est un symbole bien connu, pas une méthode. Une propriété d’objet ayant cette clé peut fournir la chaîne utilisée par Object.prototype.toString.call(value) pour produire un résultat tel que [object Widget]. La clé symbole n’est pas la même que la clé chaîne "Symbol.toStringTag".

La méthode lit aussi cette propriété dans la chaîne des prototypes. Si sa valeur n’est pas une chaîne, elle utilise l’étiquette par défaut, par exemple Object pour un objet ordinaire ; elle ne convertit pas la valeur en chaîne. Un getter peut être exécuté, et toute exception qu’il déclenche est propagée.

Cette étiquette est descriptive, et non un moyen fiable de vérifier le type : elle peut être usurpée. Elle ne modifie ni typeof, ni le prototype, ni les capacités internes de l’objet. Elle ne remplace pas non plus une méthode toString() personnalisée et ne contrôle pas, de manière générale, la conversion en valeur primitive — ce rôle revient à Symbol.toPrimitive.

Exemples

const item = { [Symbol.toStringTag]: "Widget" };
console.log(Object.prototype.toString.call(item));

item[Symbol.toStringTag] = 42;
console.log(Object.prototype.toString.call(item));
console.log(typeof item);

Résultat

[object Widget]
[object Object]
object

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources