Symbol.toStringTag
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 avril 2017.
Le symbole connu Symbol.toStringTag est une propriété qui est une chaîne de caractères qui est utilisée pour la description textuelle par défaut d'un objet. Ce symbole est utilisé par le moteur JavaScript via la méthode Object.prototype.toString().
Exemple interactif
class ValidatorClass {
get [Symbol.toStringTag]() {
return "Validator";
}
}
console.log(Object.prototype.toString.call(new ValidatorClass()));
// Expected output: "[object Validator]"
Attributs de Symbol.toStringTag | |
|---|---|
| Écrivable | Non |
| Énumérable | Non |
| Configurable | Non |
Description
La plupart des types JavaScript ont des étiquettes par défaut :
js
Object.prototype.toString.call("toto"); // "[object String]"
Object.prototype.toString.call([1, 2]); // "[object Array]"
Object.prototype.toString.call(3); // "[object Number]"
Object.prototype.toString.call(true); // "[object Boolean]"
Object.prototype.toString.call(undefined); // "[object Undefined]"
Object.prototype.toString.call(null); // "[object Null]"
// etc.
D'autres ont le symbole natif toStringTag défini :
js
Object.prototype.toString.call(new Map()); // "[object Map]"
Object.prototype.toString.call(function* () {}); // "[object GeneratorFunction]"
Object.prototype.toString.call(Promise.resolve()); // "[object Promise]"
// etc.
Lorsqu'on crée des classes personnalisées, JavaScript utilise l'étiquette "Object" par défaut :
js
class ValidatorClass {}
Object.prototype.toString.call(new ValidatorClass()); // "[object Object]"
Si on utilise le symbole toStringTag on peut définir une étiquette personnalisée :
js
class ValidatorClass {
get [Symbol.toStringTag]() {
return "Validator";
}
}
Object.prototype.toString.call(new ValidatorClass()); // "[object Validator]"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.tostringtag |