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.

El método [@@toPrimitive]() convierte un objeto Symbol en un valor primitivo.

Sintaxis

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

Valor de retorno

El valor primitivo del objeto Symbol especificado.

Descripción

El método [@@toPrimitive]() de Symbol devuelve el valor primitivo de un objeto Symbol como un tipo de datos Symbol. El argumento hint no se utiliza.

JavaScript llama al método [@@toPrimitive]() para convertir un objeto en un valor primitivo. Rara vez es necesario invocar el método [@@toPrimitive](); JavaScript lo invoca automáticamente cuando encuentra un objeto del que se espera un valor primitivo.

Ejemplos

Uso de @@toPrimitive

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

Especificaciones

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

Compatibilidad con navegadores

BCD tables only load in the browser

Véase también