+91 7387620624

Symbol

Introduction

The Symbol data type was introduced in ECMAScript 2015 (ES6). A Symbol is a primitive data type used to create unique and immutable identifiers.

Every Symbol value is unique, even if two Symbols are created with the same description. Symbols are commonly used as unique object property keys to avoid naming conflicts.

Although Symbols are not used as frequently as strings or numbers, they are an important feature of JavaScript and are widely used in libraries, frameworks, and advanced JavaScript programming.

What is a Symbol?

A Symbol is a primitive data type that represents a unique identifier.

Each Symbol created is guaranteed to be unique.

Example:

let id = Symbol();

console.log(id);

Output

Symbol()

Why Do We Need Symbols?

Symbols help us:

  • Create unique identifiers.

  • Avoid property name conflicts.

  • Create hidden object properties.

  • Build reusable libraries.

  • Define custom object behavior.

  • Improve code reliability.

Creating a Symbol

Use the Symbol() function.

let userId = Symbol();

console.log(userId);

Output

Symbol()

Symbol with a Description

You can provide an optional description to make debugging easier.

let id = Symbol("userId");

console.log(id);

Output

Symbol(userId)

The description is only for debugging and does not affect uniqueness.

Checking the Data Type

Use the typeof operator.

let token = Symbol();

console.log(typeof token);

Output

symbol

Every Symbol is Unique

Even if two Symbols have the same description, they are different.

let id1 = Symbol("id");

let id2 = Symbol("id");

console.log(id1 === id2);

Output

false

This is because each call to Symbol() creates a brand-new unique Symbol.

Using Symbols as Object Property Keys

Symbols are often used as object property keys.

const id = Symbol("id");

const user = {

    name: "Alice",

    [id]: 101

};

console.log(user[id]);

Output

101

Notice the square brackets ([]) around the Symbol when defining the property.

Symbol Properties Do Not Conflict

const id = Symbol("id");

const employee = {

    id: 100,

    [id]: 200

};

console.log(employee.id);

console.log(employee[id]);

Output

100
200

Although both properties appear to have the same name, they are completely different because one uses a string key and the other uses a Symbol.

Converting a Symbol to a String

Use the toString() method.

let sym = Symbol("user");

console.log(sym.toString());

Output

Symbol(user)

Accessing the Symbol Description

Use the description property.

let symbol = Symbol("login");

console.log(symbol.description);

Output

login

Global Symbols

JavaScript provides a global Symbol registry using Symbol.for().

let symbol1 = Symbol.for("employee");

let symbol2 = Symbol.for("employee");

console.log(symbol1 === symbol2);

Output

true

Unlike Symbol(), Symbol.for() returns the same Symbol for the same key.

Retrieving a Global Symbol Key

Use Symbol.keyFor().

let symbol = Symbol.for("admin");

console.log(Symbol.keyFor(symbol));

Output

admin

Boolean Conversion

All Symbol values are truthy.

let symbol = Symbol();

console.log(Boolean(symbol));

Output

true

Real-World Example

Suppose a library wants to store internal information without conflicting with user-defined properties.

const internalId = Symbol("internalId");

const product = {

    name: "Laptop",

    [internalId]: 5001

};

console.log(product.name);

console.log(product[internalId]);

Output

Laptop
5001

Automation Testing Example

Although Symbols are not commonly used in Selenium or Playwright automation scripts, you may encounter them while working with JavaScript libraries or frameworks.

Example:

const uniqueTestId = Symbol("testId");

const testData = {

    name: "Login Test",

    [uniqueTestId]: 101

};

console.log(testData[uniqueTestId]);

Output

101

This ensures that the identifier does not conflict with other object properties.

Common Mistakes

Comparing Different Symbols

Incorrect assumption:

let a = Symbol("id");

let b = Symbol("id");

console.log(a === b);

Output

false

Each Symbol is unique, even with the same description.

Forgetting Square Brackets

Incorrect:

const id = Symbol("id");

const user = {

    id: 100

};

This creates a normal property named "id".

Correct:

const id = Symbol("id");

const user = {

    [id]: 100

};

Using new Symbol()

Incorrect:

let symbol = new Symbol();

Output

TypeError

Always create Symbols using:

let symbol = Symbol();

Best Practices

Use Symbols for Unique Object Keys

Symbols are ideal for creating object properties that should not conflict with other property names.

Add Descriptions

Provide meaningful descriptions for easier debugging.

const orderId = Symbol("orderId");

Use Symbol.for() Only When Sharing Symbols

Use Symbol.for() when multiple parts of your application need access to the same Symbol.

Avoid Overusing Symbols

For regular object properties, use strings. Reserve Symbols for cases where uniqueness is important.

Conclusion

The Symbol data type provides a reliable way to create unique identifiers in JavaScript. Every Symbol is unique, making it ideal for object property keys that should never conflict with existing properties.

Although Symbols are considered an advanced JavaScript feature, they are widely used in frameworks, libraries, and complex applications to improve reliability and prevent naming collisions. Understanding Symbols will help you write more robust and maintainable JavaScript code.

Frequently Asked Questions (FAQs)

What is a Symbol in JavaScript?

A Symbol is a primitive data type used to create unique and immutable identifiers.

How do I create a Symbol?

Use the Symbol() function.

Example:

let id = Symbol();

Are two Symbols with the same description equal?

No.

Symbol("id") === Symbol("id");

Output:

false

What is Symbol.for()?

Symbol.for() creates or retrieves a Symbol from the global Symbol registry.

Why are Symbols useful?

Symbols help create unique object property keys, avoid naming conflicts, and build more reliable JavaScript applications.

Key Takeaways

  • Symbol is a primitive data type introduced in ES6.

  • Every Symbol created with Symbol() is unique.

  • Symbols are commonly used as unique object property keys.

  • typeof returns "symbol" for Symbol values.

  • Symbol descriptions are used only for debugging.

  • Symbol.for() accesses the global Symbol registry.

  • Symbol.keyFor() retrieves the key of a global Symbol.

  • Symbol properties help prevent naming conflicts.

  • Symbols are truthy values.

  • Understanding Symbols is useful for advanced JavaScript programming and working with modern libraries and frameworks.