Symbols

从 ECMAScript 2015 开始，symbol 是一种基本数据类型，就像 number 和 string 一样。

symbol 值通过调用 Symbol 构造函数创建。

let sym1 = Symbol();

let sym2 = Symbol("key"); // optional string key

Symbol 是不可变的，并且唯一的。

let sym2 = Symbol("key");

let sym3 = Symbol("key");

sym2 === sym3; // false, symbols are unique

就像字符串一样，symbol 可以作为对象的属性

const sym = Symbol();

let obj = {
    [sym]: "value",
};

console.log(obj[sym]); // "value"

symbol 也可以与计算属性声明结合使用，去声明对象的属性和类成员。

const getClassNameSymbol = Symbol();

class C {
    [getClassNameSymbol]() {
        return "C";
    }
}

let c = new C();
let className = c[getClassNameSymbol](); // "C"

`unique symbol`

为了能够将 symbol 被视为唯一的字面量类型，可以使用特殊类型 unique symbol。unique symbol 是 symbol 的子类型，并且只能通过调用 Symbol() 或 Symbol.for() 产生，或使用显式的类型注释。这个类型只能在 const 声明和 static readonly 属性上使用，并且引用特定的唯一标识（unique symbol），需要使用 typeof 操作符。每个对唯一标识的引用，都意味着把给定声明绑定完全唯一的标识。

const sym1: unique symbol = Symbol();

// sym2 can only be a constant reference.
let sym2: unique symbol = Symbol();
Error：// A variable whose type is a 'unique symbol' type must be 'const'.

// Works - refers to a unique symbol, but its identity is tied to 'sym1'.
let sym3: typeof sym1 = sym1;

// Also works.
class C {
  static readonly StaticSymbol: unique symbol = Symbol();
}

因为每个 unique symbol 是每个单独的个体，所以两个 unique symbol 类型不能互相赋值或比较。

const sym2 = Symbol();
const sym3 = Symbol();

if (sym2 === sym3) {
  Error：// This comparison appears to be unintentional because the types 'typeof sym2' and 'typeof sym3' have no overlap.
  // ...
}