极简三分钟ES6 - Symbol

定义Symbol

想象我们要给快递包裹贴标签📦，如果我们都写"重要文件"，可能拿错。Symbol 就像一张独一无二的定制标签，即使内容描述相同，每张标签的"防伪码"也完全不同

js 复制代码

// 创建两个描述相同的 Symbol 
const label1 = Symbol("重要文件");
const label2 = Symbol("重要文件");
console.log(label1  === label2); // false（本质上是两个不同的标签）

本质：Symbol 是 ES6 新增的第七种基本数据类型 （与数字、字符串并列），用于生成唯一的标识符

核心特性详解

1、 唯一性：彻底解决命名冲突

问题场景：同事之间协作时，可能意外覆盖对象的同名属性

js 复制代码

// 同事的代码 
const user = { id: "A123" };
user.id  = "临时ID"; // 不小心覆盖了原始ID！

Symbol 方案 用 Symbol 作为属性名，确保永不重复

js 复制代码

const idSymbol = Symbol("唯一ID标识");
const user = { [idSymbol]: "A123" };
// 其他人无法直接访问或覆盖 
user.id  = "临时ID"; // 新增普通属性，不影响 Symbol 属性 
console.log(user[idSymbol]);  // 安全输出 "A123"

2、 不可见性：隐藏关键属性 Symbol 属性默认不会出现在常规遍历中

js 复制代码

const secretKey = Symbol("密钥");
const config = {
  api: "https://xxx.com", 
  [secretKey]: "ABCD-1234"
};
// 以下方法均无法获取 Symbol 属性 
console.log(Object.keys(config));  // ["api"]
console.log(JSON.stringify(config));  // {"api":"https://xxx.com"}

用途：

保护内部逻辑（如私有属性）
避免第三方库误操作关键数据

3、 全局共享：跨模块复用 Symbol 通过 Symbol.for() 注册全局 Symbol，相同描述符返回同一实例

js 复制代码

// 模块A 中注册 
const globalSymbol = Symbol.for("APP_FLAG"); 
// 模块B 中获取 
const sameSymbol = Symbol.for("APP_FLAG"); 
console.log(globalSymbol  === sameSymbol); // true

适用场景：跨文件共享配置标识

一些常见的使用场景

扩展对象功能（内置 Symbol）

ES6 内置的 Symbol 值可定制对象行为

Symbol.iterator ：使对象可被 for...of 遍历

js 复制代码

const myList = {
  [Symbol.iterator]: function* () {
    yield "🍎";
    yield "🍌";
  }
};
for (const item of myList) console.log(item);  // 依次输出苹果、香蕉

Symbol.toStringTag ：自定义 toString() 输出

js 复制代码

const myObj = {
  [Symbol.toStringTag]: "MyCustomObject"
};
console.log(myObj.toString());  // [object MyCustomObject]

替代常量避免冲突

传统常量仍可能被覆盖，使用Symbol 更安全

js 复制代码

// 传统常量（有风险）
const LOG_LEVEL = { DEBUG: 1 };
// Symbol 方案 
const LOG_LEVEL = {
  DEBUG: Symbol("debug"),
  ERROR: Symbol("error")
};

使用时需要注意

特性	说明
非构造函数	禁止 `new Symbol()`，直接 `Symbol()` 调用 2
类型转换	无法隐式转字符串（需显式调用 `symbol.toString()` ）
属性获取	需通过 `Object.getOwnPropertySymbols()` 获取 Symbol 属性

何时使用 Symbol

需要绝对唯一的属性名（如插件开发防冲突）
定义内部私有属性 （替代传统 _private 约定）
扩展对象内置行为（迭代器、类型标签等）

牢记

Symbol = 防伪码 + 隐身衣 不但能给关键属性贴上"无法伪造的标签"，还能自动"隐身"防窥探，从此告别命名冲突