Symbol 特性

ES6 引入了一种新的原始数据类型 Symbol，表示独一无二的值。

Symbol 值通过 Symbol 函数生成，使用 typeof，结果为 “symbol”。 ```javascript var a = Symbol(); console.log(typeof a); // “symbol”


2. Symbol 函数前不能使用 new 命令，否则会报错。因为生成的 Symbol 是一个原始类型的值，不是对象。
3. instanceof 的结果为 false
```javascript
var s = Symbol("foo");
console.log(s instanceof Symbol); // false

Symbol 函数可以接受一个字符串作为参数，表示对 Symbol 实例的描述，主要是为了在控制台显示，或者转为字符串时，比较容易区分。 ```javascript var s1 = Symbol(“foo”); console.log(s1); // Symbol(foo)


5. 如果 Symbol 的参数是一个对象，就会调用该对象的 toString 方法，将其转为字符串，然后才生成一个 Symbol 值。
```javascript
const obj =  {
    toString() {
        return 'abc';
    }
};
const sym = Symbol(obj);
console.log(sym); // Symbol(abc)

Symbol 函数的参数只是表示对当前 Symbol 值的描述，相同参数的 Symbol 函数的返回值是不相等的。 ```javascript // 没有参数的情况 var s1 = Symbol(); var s2 = Symbol();

console.log(s1 === s2); // false

// 有参数的情况 var s3 = Symbol(“foo”); var s4 = Symbol(“foo”);

console.log(s3 === s4); // false


7. Symbol 值不能与其类型的值进行运算，会报错。
```javascript
var sym = Symbol("My symbol");
console.log("Your symbol is " + sym); // TypeError: can't convert symbol to string

Symbol 值可以显式转为字符串。 ```javascript var sym = Symbol(“My Symbol”); console.log(String(sym)); // ‘Symbol(My symbol)’ console.log(sym.toString()); // ‘Symbol(My symbol)’


9. Symbol 值可以作为标识符，用于对象的属性名，可以保证不会出现同名的属性。
```javascript
var mySymbol = Symbol();
// 第一种写法
var a = {};
a[mySymbol] = 'Hello!';
// 第二种写法
var a = {
    [mySymbol]: 'Hello!'
};
// 第三种写法
var a = {};
Object.defineProperty(a, mySymbol, {value: 'Hello!'});

Symbol 作为属性名，该属性不会出现在 for…in、for…of 循环中，也不会被 Object.keys()、Object.getOwnPropertyNames()、JSON.stringify() 返回。但是，它也不是私有属性，有一个 Object.getOwnPropertySymbols 方法，可以获取指定对象的所有 Symbol 属性名。 ```javascript var obj = {}; var a = Symbol(“a”); var b = Symbol(“b”);

obj[a] = “Hello”; obj[b] = “World”;

var objectSymbols = Object.getOwnPropertySymbols(obj);

console.log(objectSymbols); // [Symbol(a), Symbol(b)]


11. 如果我们希望使用同一个 Symbol 值，可以使用 Symbol.for。它接受一个字符串作为参数，然后搜索有没有以该参数作为名称的 Symbol 值。如果有，就返回这个 Symbol 值，否则就新建并返回一个以该字符串为名称的 Symbol 值。
```javascript
var s1 = Symbol.for("foo");
var s2 = Symbol.for("foo");
console.log(s1 === s2); // true

Symbol.keyFor 方法返回一个已在全局登记的 Symbol 类型值的 key。 ```javascript var s1 = Symbol.for(“foo”); console.log(Symbol.keyFor(s1)); // “foo”

var s2 = Symbol(“foo”); console.log(Symbol.keyFor(s2)); // undefined


规范中对调用 Symbol 时的描述：
> Symbol([ descirption ])
> When Symbol is called with optional argument description, the following steps are taken:
> 1. If NewTarget is not undefined, throw a TypeError exception.
> 1. If description is undefined, var descString be undefined.
> 1. Else, var descString be ToString(description).
> 1. ReturnIfAbrupt(descString).
> 1. Return a new unique Symbol value whose [[Description]] value is descString.
<br />大白话翻译：
当调用 Symbol 的时候，会采用下面的步骤：
1. 如果使用 new，就报错。
1. 如果 description 是 undefined，让 descString 为 undefined。
1. 否则让 descString 为 ToString(description)。
1. 如果报错，就返回。
1. 返回一个新的唯一的 Symbol 值，它的内部属性 [[Description]] 值为 descString。
因为有一个内部属性 [[Description]]，如果直接返回一个基本类型是做不到这一点的，所以还是返回一个对象。
<a name="LzX6c"></a>
# 第一版
```javascript
// 第一版
(function() {
    var root = this;
    var SymbolPolyfill = function Symbol(description) {
        // 实现第 2 点，new 会报错
        if (this instanceof SymbolPolyfill) throw new TypeError('Symbol is not a constructor');
        // 实现第 5 点，如果 Symbol 的参数是一个对象，就会调用该对象的 toString 方法，将其转为字符串，然后才生成一个 Symbol 值。
        var descString = description === undefined ? undefined : String(description)
        var symbol = Object.create(null)
        Object.defineProperties(symbol, {
            '__Description__': {
                value: descString,
                writable: false,
                enumerable: false,
                configurable: false
            }
        });
        // 实现第 6 点，返回的是一个新对象，两个对象之间，只要引用不同，就不会相同
        return symbol;
    }
    root.SymbolPolyfill = SymbolPolyfill;
})();

已经实现了特性的 2、5、6 点。

第二版

使用 typeof，结果为 “symbol”。（对应第 1 点）

**
利用 es5，并不能修改 typeof 操作符的结果，所以无法实现。

instanceof 的结果为 false。（对应第 3 点）

**
因为不是通过 new 的方法生成对象的，所以 instanceof 自然为 false。

Symbol 函数可以接受一个字符串作为参数，表示对 Symbol 实例的描述，主要是为了在控制台显示，或者转为字符串时，比较容易区分。（对应第 4 点）
```
console.log(Symbol('primitive Symobl')); // Symbol(primitive Symbol)
```
模拟实现的 Symbol 返回的是一个对象，所以这一点无法实现。
Symbol 可显式转为字符串。（对应第 8 点）

Programing learning note

Symbol 模拟实现

Symbol 特性

第二版