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

Compatibilidad con navegadores

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

Véase también