Saltar al contenido
Fundamentos del lenguaje

Symbols

Lección 7 de 99 min4 ejercicios

El symbol es el primitivo menos conocido de JavaScript. No es un texto ni un número: es un valor único, garantizado distinto de cualquier otro. Casi no vas a crearlos a diario, pero el propio lenguaje los usa para funcionar por dentro.

Qué mirar en el pizarrón

Fíjate en dos cosas: dos símbolos con la misma descripción no son iguales, y una propiedad con clave símbolo existe pero no aparece al listar las claves del objeto.

En el pizarrón

const id1 = Symbol("id");const id2 = Symbol("id");console.log(id1 === id2); const usuario = { nombre: "Ana", [id1]: 123 };console.log(Object.keys(usuario));console.log(usuario[id1]);

Variables

  1. id1symbol · Symbol(id), único #1
Consola(vacía)

Symbol("id") crea un valor único. El texto "id" es solo una descripción para reconocerlo al depurar.

Con el foco aquí también puedes avanzar y retroceder con las flechas del teclado.

Ver todos los pasos en texto
  1. Paso 1: Symbol("id") crea un valor único. El texto "id" es solo una descripción para reconocerlo al depurar. Variables: id1 symbol · Symbol(id), único #1.
  2. Paso 2: Otro Symbol("id") crea otro símbolo distinto, aunque tenga la misma descripción. Variables: id1 symbol · Symbol(id), único #1, id2 symbol · Symbol(id), único #2.
  3. Paso 3: Por eso id1 === id2 es false: cada Symbol() es irrepetible. Variables: id1 symbol · Symbol(id), único #1, id2 symbol · Symbol(id), único #2.
  4. Paso 4: Un símbolo puede ser la clave de una propiedad. Se escribe entre corchetes: [id1]: 123. Variables: id1 symbol · Symbol(id), único #1, id2 symbol · Symbol(id), único #2, usuario → objeto #1, objeto #1 { nombre: 'Ana', [Symbol(id)]: 123 }.
  5. Paso 5: Object.keys lista solo las claves de texto. Las claves símbolo quedan ocultas de los recorridos normales y de JSON.stringify. Variables: id1 symbol · Symbol(id), único #1, id2 symbol · Symbol(id), único #2, usuario → objeto #1, objeto #1 { nombre: 'Ana', [Symbol(id)]: 123 }.
  6. Paso 6: Pero la propiedad existe: con el símbolo exacto la lees sin problema. Solo quien tiene id1 puede encontrarla. Variables: id1 symbol · Symbol(id), único #1, id2 symbol · Symbol(id), único #2, usuario → objeto #1, objeto #1 { nombre: 'Ana', [Symbol(id)]: 123 }.

Crear un símbolo

Un símbolo se crea llamando a Symbol(), sin new. Puedes darle una descripción, que solo sirve para reconocerlo al depurar:

const id = Symbol("id");

console.log(typeof id);        // symbol
console.log(id.description);   // id
console.log(id.toString());    // Symbol(id)

Lo que lo hace especial es que cada símbolo es único. Dos símbolos con la misma descripción siguen siendo distintos:

console.log(Symbol("id") === Symbol("id"));  // false

Símbolos como claves de propiedad

El uso principal de un símbolo es servir de clave en un objeto. Se escribe entre corchetes:

const visto = Symbol("visto");

const articulo = {
  titulo: "Aprende JS",
  [visto]: true,
};

console.log(articulo[visto]);       // true
console.log(Object.keys(articulo)); // [ 'titulo' ]
console.log(JSON.stringify(articulo)); // {"titulo":"Aprende JS"}

Una propiedad con clave símbolo tiene dos ventajas:

  • No choca con ninguna otra: aunque el objeto tenga otra propiedad llamada visto, tu símbolo es otra clave.
  • No aparece en Object.keys, en los bucles for…in ni en JSON.stringify. El objeto se ve y se guarda igual que antes.

Por eso las librerías los usan para guardar datos propios en objetos que no les pertenecen, sin riesgo de pisar nada.

El registro global: Symbol.for

A veces quieres que distintas partes del programa compartan el mismo símbolo. Para eso existe un registro global: Symbol.for(clave) busca un símbolo con esa clave y, si no existe, lo crea:

const a = Symbol.for("app.usuario");
const b = Symbol.for("app.usuario");

console.log(a === b);              // true: es el mismo
console.log(Symbol.keyFor(a));     // app.usuario

Usa una clave con un prefijo propio, como "app.", para no coincidir con el registro de otra librería.

Los símbolos que usa el propio lenguaje

JavaScript define varios símbolos conocidos (well-known symbols) que le permiten a tus objetos engancharse a comportamientos del lenguaje. El más famoso es Symbol.iterator: si un objeto tiene un método con esa clave, se puede recorrer con for…of.

console.log(typeof Symbol.iterator);              // symbol
console.log(typeof "hola"[Symbol.iterator]);      // function: los strings son recorribles

Los vas a usar en las secciones de Iteradores y generadores y Metaprogramación. Por ahora basta con saber que existen y que son símbolos.

Resumen

  • Symbol("descripción") crea un valor único, sin new. Dos símbolos nunca son iguales.
  • Sirven como claves de propiedad que no chocan con otras y quedan fuera de Object.keys, for…in y JSON.
  • No son seguridad: se pueden listar con Object.getOwnPropertySymbols.
  • Symbol.for(clave) comparte un mismo símbolo en todo el programa.
  • El lenguaje usa símbolos conocidos, como Symbol.iterator, para comportamientos como for…of.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Valores únicos

Elige una respuesta en cada pregunta.

  1. ¿Qué da Symbol("a") === Symbol("a")?

  2. ¿Y Symbol.for("a") === Symbol.for("a")?

  3. ¿Qué imprime JSON.stringify({ a: 1, [Symbol("b")]: 2 })?

  4. ¿Para qué sirve un símbolo?

Ordena la salida: Una propiedad con clave símbolo

Ordena los resultados tal como aparecerían en la consola.

const s = Symbol("color");const obj = { forma: "círculo", [s]: "rojo" }; console.log(typeof s);console.log(s.description);console.log(obj[s]);console.log(JSON.stringify(obj));console.log(Object.keys(obj).length);

Consola, de arriba abajo

  1. rojo
  2. 1
  3. symbol
  4. {"forma":"círculo"}
  5. color

Detective: Un símbolo con new

Alguien intentó crear un símbolo y obtuvo este error. Encuentra la línea y elige el arreglo.

Consola

usuario.js:2
const id = new Symbol("id");
           ^

TypeError: Symbol is not a constructor

Paso 1: toca la línea de código que causa el error.

Laboratorio: Una marca que no pisa nada

Tienes que agregarle una marca interna a un objeto que no es tuyo, pero el código actual pisa su id. Usa un símbolo para que la marca conviva con el id original.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Imprime 7, después interno-42 y después 2 (pendiente)
  • usuario.id sigue valiendo 7 (pendiente)
  • La marca usa un Symbol como clave (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.