Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Symbol.prototype.description

Baseline
Ampliamente disponible

Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde enero de 2020.

La propiedad description de sólo lectura es una cadena que devuelve la descripción opcional de los objetos Symbol.

Pruébalo

console.log(Symbol("desc").description);
// Expected output: "desc"

console.log(Symbol.iterator.description);
// Expected output: "Symbol.iterator"

console.log(Symbol.for("foo").description);
// Expected output: "foo"

console.log(`${Symbol("foo").description}bar`);
// Expected output: "foobar"

Descripción

Los objetos Symbol pueden ser creados con una descripción opcional que puede ser usada para depuración pero no para acceder al símbolo en sí. La propiedad Symbol.prototype.description puede utilizarse para leer esa descripción. Es diferente a Symbol.prototype.toString() ya que no contiene la cadena "Symbol()" que la rodea. Vea los ejemplos.

Ejemplos

Uso de description

js
Symbol("desc").toString(); // "Symbol(desc)"
Symbol("desc").description; // "desc"
Symbol("").description; // ""
Symbol().description; // undefined

// well-known symbols
Symbol.iterator.toString(); // "Symbol(Symbol.iterator)"
Symbol.iterator.description; // "Symbol.iterator"

// global symbols
Symbol.for("foo").toString(); // "Symbol(foo)"
Symbol.for("foo").description; // "foo"

Especificaciones

Especificación
ECMAScript® 2027 Language Specification
# sec-symbol.prototype.description

Compatibilidad con navegadores

Véase también