Symbol() constructor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since septiembre de 2015.

El constructor Symbol() devuelve un valor de tipo symbol, pero está incompleto como constructor porque no soporta la sintaxis "new Symbol()" y no está pensado para ser heredado. Puede utilizarse como valor de una cláusula extends de una definición de class, pero una llamada a super provocará una excepción.

Pruébalo

const symbol1 = Symbol();
const symbol2 = Symbol(42);
const symbol3 = Symbol("foo");

console.log(typeof symbol1);
// Expected output: "symbol"

console.log(symbol2 === 42);
// Expected output: false

console.log(symbol3.toString());
// Expected output: "Symbol(foo)"

console.log(Symbol("foo") === Symbol("foo"));
// Expected output: false

Sintaxis

js
Symbol();
Symbol(description);

Parámetros

description Opcional

Una cadena. Una descripción del símbolo que puede utilizarse para la depuración pero no para acceder al símbolo en sí.

Ejemplos

Crear símbolos

Para crear un nuevo símbolo primitivo, se escribe Symbol() con una cadena opcional como descripción:

js
let sym1 = Symbol();
let sym2 = Symbol("foo");
let sym3 = Symbol("foo");

El código anterior crea tres nuevos símbolos. Tenga en cuenta que Symbol("foo") no coacciona la cadena "foo" en un símbolo. Cada vez crea un nuevo símbolo:

Symbol("foo") === Symbol("foo"); // false

new Symbol()

La siguiente sintaxis con el operador new lanzará un TypeError:

let sym = new Symbol(); // TypeError

Esto evita que los autores creen un objeto envolvente explícito Symbol en lugar de un nuevo valor de símbolo y podría ser sorprendente ya que la creación de objetos envolventes explícitos alrededor de tipos de datos primitivos es generalmente posible (por ejemplo, new Boolean, new String y new Number).

Si realmente quieres crear un objeto envolvente Symbol, puedes utilizar la función Object():

js
let sym = Symbol("foo");
let symObj = Object(sym);
typeof sym; // => "symbol"
typeof symObj; // => "object"

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 11 feb 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos globales
Symbol
Constructor
1. Symbol() constructor
Métodos estáticos
1. Symbol.for()
2. Symbol.keyFor()
Propiedades estáticas
Métodos de instancia
Propiedades de instancia
1. Symbol.prototype.description
Herencia
Object/Function
Métodos estáticos
Propiedades estáticas
Métodos de instancia
Propiedades de instancia
1. Object.prototype.__proto__
2. Object.prototype.constructor

Symbol() constructor

In this article