Symbol.prototype[Symbol.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.

Die Methode [Symbol.toPrimitive]() von Symbol-Werten gibt diesen Symbolwert zurück.

Syntax

js
symbolValue[Symbol.toPrimitive](hint)

Parameter

hint

Ein Zeichenfolgenwert, der den zurückzugebenden primitiven Wert angibt. Der Wert wird ignoriert.

Rückgabewert

Der primitive Wert des angegebenen Symbol-Objekts.

Beschreibung

Die Methode [Symbol.toPrimitive]() von Symbol gibt den primitiven Wert eines Symbol-Objekts als Symbol-Datentyp zurück. Das hint Argument wird nicht verwendet.

JavaScript ruft die Methode [Symbol.toPrimitive]() auf, um ein Objekt in einen primitiven Wert umzuwandeln. Normalerweise müssen Sie die Methode [Symbol.toPrimitive]() nicht selbst aufrufen; JavaScript ruft sie automatisch auf, wenn ein Objekt in einem Kontext auftaucht, der einen primitiven Wert erfordert.

Beispiele

Verwendung von [Symbol.toPrimitive]()

js
const sym = Symbol("example");
sym === sym[Symbol.toPrimitive](); // true

Spezifikationen

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

Browser-Kompatibilität

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

Siehe auch