Symbol.prototype[@@toPrimitive]

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

La méthode [@@toPrimitive]() permet de convertir un objet symbole en une valeur primitive.

Syntaxe

js
Symbol()[Symbol.toPrimitive](hint);

Valeur de retour

La valeur primitive de l'objet Symbol indiqué.

Description

La méthode [@@toPrimitive]() de Symbol renvoie la valeur primitive d'un objet Symbol (le résultat sera donc un symbole au sens primitif). L'argument hint n'est pas utilisé.

Le moteur JavaScript appelle la méthode [@@toPrimitive]() afin de convertir un objet en une valeur primitive. Généralement, il n'est pas nécessaire d'appeler [@@toPrimitive]() car le moteur JavaScript l'appelle automatiquement lorsqu'il détecte un objet là où une valeur primitive est attendue.

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-symbol.prototype-%symbol.toprimitive%

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
[Symbol.toPrimitive]

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi