Los que ya conoces
| Symbol | Lo usa… | Lo viste en |
|---|---|---|
Symbol.iterator |
for...of, spread, desestructuración |
El protocolo iterable |
Symbol.asyncIterator |
for await...of |
Iteración asíncrona |
Symbol.dispose |
using |
Gestión explícita de recursos |
Symbol.asyncDispose |
await using |
Gestión explícita de recursos |
Todos siguen la misma idea: el lenguaje define el nombre del gancho y tú pones la función.
Symbol.toPrimitive
Cuando un objeto tiene que convertirse en un primitivo (en una suma, un template literal, una comparación), el lenguaje busca [Symbol.toPrimitive](hint). El hint dice qué se espera:
"number":+obj,obj * 2,obj > 3"string":`${obj}`,String(obj)"default":obj + algo,obj == algo
const duracion = {
segundos: 90,
[Symbol.toPrimitive](hint) {
return hint === "string" ? `${Math.floor(this.segundos / 60)} min ${this.segundos % 60} s` : this.segundos;
},
};
console.log(`Duró ${duracion}`);
console.log(duracion * 2);
console.log(duracion > 60);
Sin él, el lenguaje prueba con valueOf() y toString(), como viste en Conversión de tipos.
Symbol.toStringTag
Cambia la etiqueta que muestra Object.prototype.toString, la forma más confiable de saber “qué es” un valor:
class Billetera {
get [Symbol.toStringTag]() {
return "Billetera";
}
}
console.log(Object.prototype.toString.call(new Billetera()));
console.log(Object.prototype.toString.call(new Map()));
console.log(Object.prototype.toString.call(null));
Symbol.hasInstance
Decide qué responde instanceof. Permite que instanceof compruebe una forma en lugar de un prototipo:
class Iterable {
static [Symbol.hasInstance](valor) {
return valor != null && typeof valor[Symbol.iterator] === "function";
}
}
console.log([1, 2] instanceof Iterable);
console.log("hola" instanceof Iterable);
console.log({} instanceof Iterable);
Otros
Symbol.isConcatSpreadable: decide siconcatreparte el objeto como un array.Symbol.species: el constructor que usan métodos comomappara crear el resultado en clases que extiendenArray.Symbol.match,replace,search,split: permiten que un objeto propio funcione como una expresión regular en los métodos de texto.Symbol.unscopables: un detalle histórico para el viejowith.
El registro global: Symbol.for
Symbol("x") crea un symbol nuevo cada vez. Symbol.for("x") lo busca en un registro global y, si no existe, lo crea: dos partes del programa que no se conocen obtienen el mismo symbol.
const a = Symbol("app.tema");
const b = Symbol("app.tema");
const c = Symbol.for("app.tema");
const d = Symbol.for("app.tema");
console.log(a === b, c === d);
console.log(Symbol.keyFor(c), Symbol.keyFor(a));
Resumen
- Los symbols conocidos son ganchos: el lenguaje busca esas claves en tus objetos.
Symbol.iterator,asyncIterator,disposeyasyncDisposeconectan confor...of,for awaityusing.Symbol.toPrimitivecontrola la conversión a número o texto según elhint.Symbol.toStringTagcambia la etiqueta deObject.prototype.toString;Symbol.hasInstance, el resultado deinstanceof.Symbol.forcomparte symbols a través de un registro global.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Ganchos del lenguaje
Resuelto
Elige una respuesta en cada pregunta.
¿Qué es un symbol conocido, como
Symbol.iterator?¿Cuándo se llama a
[Symbol.toPrimitive](hint)?¿Qué cambia
Symbol.toStringTag?¿Qué diferencia hay entre
Symbol("x")ySymbol.for("x")?
Ordena la salida: Convertir a primitivo
Resuelto
Un objeto que decide cómo convertirse según el contexto. Ordena lo que aparecería en la consola.
1const temperatura = {2 grados: 25,3 [Symbol.toPrimitive](hint) {4 if (hint === "number") return this.grados;5 if (hint === "string") return `${this.grados} °C`;6 return "temperatura";7 },8 get [Symbol.toStringTag]() {9 return "Temperatura";10 },11};12 13console.log(+temperatura);14console.log(`${temperatura}`);15console.log(temperatura + "!");16console.log(Object.prototype.toString.call(temperatura));Consola, de arriba abajo
- temperatura!
- 25
- [object Temperatura]
- 25 °C
El + unario pide un número; un template literal, un texto. El + binario no sabe si va a sumar o concatenar, así que pide "default". toStringTag cambia la etiqueta de Object.prototype.toString.
Detective: Dos symbols con el mismo nombre
Resuelto
Dos partes del programa usan “la misma” clave, pero no encuentran el ajuste. Encuentra la línea y elige el arreglo.
Consola
ajustes.js:5
console.log(ajustes[otraClave].toUpperCase());
^
TypeError: Cannot read properties of undefined (reading 'toUpperCase')Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Dinero que sabe convertirse
Resuelto
Escribe la clase Dinero con Symbol.toPrimitive.
$ node programa.js
Lo que debe cumplir
- Imprime
Total: 10.50 PENy21(pendiente) - Se puede comparar y sumar como un número (pendiente)
- Implementa
Symbol.toPrimitive(pendiente)
Una solución
1class Dinero {2 constructor(monto, moneda) {3 this.monto = monto;4 this.moneda = moneda;5 }6 7 [Symbol.toPrimitive](hint) {8 if (hint === "string") return `${this.monto.toFixed(2)} ${this.moneda}`;9 return this.monto;10 }11}12 13const precio = new Dinero(10.5, "PEN");14console.log(`Total: ${precio}`);15console.log(precio * 2);Con Symbol.toPrimitive, tu objeto decide cómo convertirse según el contexto. Úsalo con cuidado: que un objeto se comporte como un número puede sorprender a quien lea el código. Un método explícito, como precio.formatear(), suele ser más claro.