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 Language Specification
# sec-symbol.prototype-%symbol.toprimitive%

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch