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 September 2015.

The Symbol() function returns primitive values of type Symbol.

Try it

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

Syntax

js
Symbol()
Symbol(description)

Note: Symbol() can only be called without new. Attempting to construct it with new throws a TypeError.

Parameters

description Optional

A string. A description of the symbol which can be used for debugging but not to access the symbol itself.

Examples

Creating symbols

To create a new primitive symbol, you write Symbol() with an optional string as its description:

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

The above code creates three new symbols. Note that Symbol("foo") does not coerce the string "foo" into a symbol. It creates a new symbol each time:

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

new Symbol()

The following syntax with the new operator will throw a TypeError:

js
const sym = new Symbol(); // TypeError

This prevents authors from creating an explicit Symbol wrapper object instead of a new symbol value and might be surprising as creating explicit wrapper objects around primitive data types is generally possible (for example, new Boolean, new String and new Number).

If you really want to create a Symbol wrapper object, you can use the Object() function:

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

Specifications

Specification
ECMAScript® 2025 Language Specification
# sec-symbol-constructor

Browser compatibility

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() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also