JS 中的 Symbol

Symbol 是 ES6 新加入的數據類型，是一種原始數據類型。該類型的性質在於這個類型的值能夠用來建立匿名的對象屬性。該數據類型一般被用做一個對象屬性的鍵值——當你想讓它是私有的時候。對象的屬性名如今能夠有兩種類型，一種是字符串，另外一種就是 Symbol 類型。

Symbol 值經過Symbol函數生成，它是獨一無二的，能夠保證不會與其餘屬性名產生衝突。

let s1 = Symbol();
// Symbol 函數前不能使用 new 命令，不然會報錯
// 由於生成的 Symbol 是一個原始類型的值，不是對象

let s2 = Symbol();

typeof s
// "symbol"

s1 === s2 // false
// Symbol 是獨一無二的
複製代碼

打印 Symbol 類型都顯示爲 Symbol，這很差區分，這時就能夠給它傳遞一個參數，來區分 Symbol。

const obj = {
  toString() {
    return 'abc';
  }
};
const sym = Symbol(obj);
sym // Symbol(abc)

let s1 = Symbol('foo');
let s2 = Symbol('foo');

s1 === s2 // false
複製代碼

Symbol 值不能與其餘類型的值進行運算

let sym = Symbol('My symbol');

"your symbol is " + sym
// TypeError: can't convert symbol to string
`your symbol is ${sym}`
// TypeError: can't convert symbol to string
複製代碼

Symbol 值能夠顯式轉爲字符串和布爾值，可是不能轉爲數值。

let sym = Symbol('My symbol');

String(sym) // 'Symbol(My symbol)'
sym.toString() // 'Symbol(My symbol)'

let sym = Symbol();
Boolean(sym) // true
!sym  // false

Number(sym) // TypeError
sym + 2 // TypeError
複製代碼

做爲屬性名

Symbol 值能夠做爲屬性名，通常用來實現私有屬性。

let mySymbol = Symbol();
let s = Symbol();

// 第一種寫法
let a = {};
a[mySymbol] = 'Hello!';

// 第二種寫法
let a = {
  [mySymbol]: 'Hello!',
  [s] (arg) { }
};

// 第三種寫法
let a = {};
Object.defineProperty(a, mySymbol, { value: 'Hello!' });

// 以上寫法都獲得一樣結果
a[mySymbol] // "Hello!"
複製代碼

遍歷屬性名

Symbol 做爲屬性名，該屬性不會出如今for...in、for...of循環中，也不會被Object.keys()、Object.getOwnPropertyNames()、JSON.stringify()返回。

可是，Object.getOwnPropertySymbols方法，能夠獲取指定對象的全部 Symbol 屬性名，Reflect.ownKeys方法能夠返回全部類型的鍵名，包括常規鍵名和 Symbol 鍵名。

const obj = {};
let a = Symbol('a');
let b = Symbol('b');

obj[a] = 'Hello';
obj[b] = 'World';

const objectSymbols = Object.getOwnPropertySymbols(obj);

objectSymbols
// [Symbol(a), Symbol(b)]

複製代碼

Symbol 的靜態方法

Symbol 一共有兩個靜態方法Symbol.for(key)和Symbol.keyFor(sym)。

for

Symbol.for(key)方法會根據給定的鍵key，來從運行時的symbol註冊表中找到對應的 symbol，若是找到了，則返回它，不然，新建一個與該鍵關聯的symbol，並放入全局symbol 註冊表中。

Symbol.for("foo"); // 建立一個 symbol 並放入 symbol 註冊表中，鍵爲 "foo"
Symbol.for("foo"); // 從 symbol 註冊表中讀取鍵爲"foo"的 symbol


Symbol.for("bar") === Symbol.for("bar"); // true，證實了上面說的
Symbol("bar") === Symbol("bar"); // false，Symbol() 函數每次都會返回新的一個 symbol


var sym = Symbol.for("mario");
sym.toString(); 
// "Symbol(mario)"，mario 既是該 symbol 在 symbol 註冊表中的鍵名，又是該 symbol 自身的描述字符串
複製代碼

keyFor

Symbol.keyFor(sym)方法用來獲取symbol註冊表中與某個symbol關聯的鍵。

// 建立一個 symbol 並放入 Symbol 註冊表，key 爲 "foo"
var globalSym = Symbol.for("foo"); 
Symbol.keyFor(globalSym); // "foo"

// 建立一個 symbol，但不放入 symbol 註冊表中
var localSym = Symbol(); 
Symbol.keyFor(localSym); // undefined，因此是找不到 key 的

// well-known symbol 們並不在 symbol 註冊表中
Symbol.keyFor(Symbol.iterator) // undefined

let s1 = Symbol.for("foo");
Symbol.keyFor(s1) // "foo"

let s2 = Symbol("foo");
Symbol.keyFor(s2) // undefined
// Symbol()寫法沒有登記機制，因此每次調用都會返回一個不一樣的值
複製代碼

內置的 Symbol 值 （Well-known symbols）

ES6 提供了 12 個內置的 Symbol 值，指向語言內部使用的方法。

迭代 symbols

Symbol.iterator

指向該對象的默認遍歷器方法。

Symbol.asyncIterator

指向該對象的默認異步遍歷器方法。

正則表達式 symbols

Symbol.match

指向一個函數。String.prototype.match()方法執行時若是該屬性存在，會調用此函數，返回該方法的返回值。

String.prototype.match(regexp)
// 等同於
regexp[Symbol.match](this)

class MyMatcher {
  [Symbol.match](string) {
    return 'hello world'.indexOf(string);
  }
}

'e'.match(new MyMatcher()) // 1

"/bar/".startsWith(/bar/); 

// Throws TypeError, 由於 /bar/ 是一個正則表達式
// 且 Symbol.match 沒有修改。

var re = /foo/;
re[Symbol.match] = false;
"/foo/".startsWith(re); // true
"/baz/".endsWith(re);   // false

// 若是將 Symbol.match 置爲 false，
// 使用 match 屬性的表達式檢查會認爲該對象不是正則表達式對象
複製代碼

Symbol.replace

指向一個方法，當該對象被String.prototype.replace方法調用時，會返回該方法的返回值。

String.prototype.replace(searchValue, replaceValue)
// 等同於
searchValue[Symbol.replace](this, replaceValue)

const x = {};
x[Symbol.replace] = (...s) => console.log(s);

'Hello'.replace(x, 'World') // ["Hello", "World"]
複製代碼

Symbol.search

指向一個方法，當該對象被String.prototype.search方法調用時，會返回該方法的返回值。

String.prototype.search(regexp)
// 等同於
regexp[Symbol.search](this)

class MySearch {
  constructor(value) {
    this.value = value;
  }
  [Symbol.search](string) {
    return string.indexOf(this.value);
  }
}
'foobar'.search(new MySearch('foo')) // 0

複製代碼

Symbol.split

指向一個方法，當該對象被String.prototype.split方法調用時，會返回該方法的返回值。

class MySplitter {
  constructor(value) {
    this.value = value;
  }
  [Symbol.split](string) {
    let index = string.indexOf(this.value);
    if (index === -1) {
      return string;
    }
    return [
      string.substr(0, index),
      string.substr(index + this.value.length)
    ];
  }
}

'foobar'.split(new MySplitter('foo'))
// ['', 'bar']

'foobar'.split(new MySplitter('bar'))
// ['foo', '']

'foobar'.split(new MySplitter('baz'))
// 'foobar'
複製代碼

其餘 symbols

Symbol.hasInstance

指向一個內部方法。當其餘對象使用instanceof運算符，判斷是否爲該對象的實例時，會調用這個方法。

class Even {
  static [Symbol.hasInstance](obj) {
    return Number(obj) % 2 === 0;
  }
}

// 等同於
const Even = {
  [Symbol.hasInstance](obj) {
    return Number(obj) % 2 === 0;
  }
};

1 instanceof Even // false
2 instanceof Even // true
12345 instanceof Even // false
複製代碼

Symbol.isConcatSpreadable

等於一個布爾值，表示該對象用於Array.prototype.concat()時，是否能夠展開。

let arr1 = ['c', 'd'];
['a', 'b'].concat(arr1, 'e') // ['a', 'b', 'c', 'd', 'e']
arr1[Symbol.isConcatSpreadable] // undefined

let arr2 = ['c', 'd'];
arr2[Symbol.isConcatSpreadable] = false;
['a', 'b'].concat(arr2, 'e') // ['a', 'b', ['c','d'], 'e']

// ----------

let obj = {length: 2, 0: 'c', 1: 'd'};
['a', 'b'].concat(obj, 'e') // ['a', 'b', obj, 'e']

obj[Symbol.isConcatSpreadable] = true;
['a', 'b'].concat(obj, 'e') // ['a', 'b', 'c', 'd', 'e']
複製代碼

Symbol.unscopables

指向一個對象。該對象指定了使用with關鍵字時，哪些屬性會被with環境排除。

Array.prototype[Symbol.unscopables]
// {
// copyWithin: true,
// entries: true,
// fill: true,
// find: true,
// findIndex: true,
// includes: true,
// keys: true
// }

// 數組有 7 個屬性，會被with命令排除
複製代碼

Symbol.species

指向一個構造函數。建立衍生對象時，會使用該屬性。

class MyArray extends Array {
}

const a = new MyArray(1, 2, 3);
const b = a.map(x => x);
const c = a.filter(x => x > 1);

b instanceof MyArray // true
c instanceof MyArray // true
// b 和 c 是 a 的衍生對象

// ---------

class MyArray extends Array {
  static get [Symbol.species]() { return Array; }
}

const a = new MyArray();
const b = a.map(x => x);

b instanceof MyArray // false
b instanceof Array // true
複製代碼

Symbol.toPrimitive

指向一個方法。該對象被轉爲原始類型的值時，會調用這個方法，返回該對象對應的原始類型值。

能夠接受一個字符串參數，表示當前運算的模式，一共有三種模式。

• Number：該場合須要轉成數值
• String：該場合須要轉成字符串
• Default：該場合能夠轉成數值，也能夠轉成字符串

let obj = {
  [Symbol.toPrimitive](hint) {
    switch (hint) {
      case 'number':
        return 123;
      case 'string':
        return 'str';
      case 'default':
        return 'default';
      default:
        throw new Error();
     }
   }
};

2 * obj // 246
3 + obj // '3default'
obj == 'default' // true
String(obj) // 'str'
複製代碼

Symbol.toStringTag

指向一個方法。在該對象上面調用Object.prototype.toString方法時，若是這個屬性存在，它的返回值會出如今toString方法返回的字符串之中，表示對象的類型。

這個屬性能夠用來定製[object Object]或[object Array]中object後面的那個字符串。

({[Symbol.toStringTag]: 'Foo'}.toString())
// "[object Foo]"

class Collection {
  get [Symbol.toStringTag]() {
    return 'xxx';
  }
}
let x = new Collection();
Object.prototype.toString.call(x) // "[object xxx]"
複製代碼

ES6 內置對象屬性值：

JSON[Symbol.toStringTag]：'JSON' Math[Symbol.toStringTag]：'Math' Module 對象M[Symbol.toStringTag]：'Module' ArrayBuffer.prototype[Symbol.toStringTag]：'ArrayBuffer' DataView.prototype[Symbol.toStringTag]：'DataView' Map.prototype[Symbol.toStringTag]：'Map' Promise.prototype[Symbol.toStringTag]：'Promise' Set.prototype[Symbol.toStringTag]：'Set' %TypedArray%.prototype[Symbol.toStringTag]：'Uint8Array'等 WeakMap.prototype[Symbol.toStringTag]：'WeakMap' WeakSet.prototype[Symbol.toStringTag]：'WeakSet' %MapIteratorPrototype%[Symbol.toStringTag]：'Map Iterator' %SetIteratorPrototype%[Symbol.toStringTag]：'Set Iterator' %StringIteratorPrototype%[Symbol.toStringTag]：'String Iterator' Symbol.prototype[Symbol.toStringTag]：'Symbol' Generator.prototype[Symbol.toStringTag]：'Generator' GeneratorFunction.prototype[Symbol.toStringTag]：'GeneratorFunction'

Symbol 原型

Symbol 一共有 4 個原型方法。

Symbol.prototype.toSource()

返回表明該對象源碼的字符串。該方法一般由JavaScript內部調用。

對於內建Symbol對象, toSource 返回如下字符串，代表源代碼不可見：

` function Symbol() { [native code] } `
複製代碼

對於Symbol實例, toSource 返回表明源碼的字符串。

"Symbol()"
複製代碼

Symbol.prototype.toString()

返回當前 symbol 對象的字符串表示。

Symbol.prototype.valueOf()

返回當前 symbol 對象所包含的 symbol 原始值。

Symbol.prototype[@@toPrimitive]

可將 Symbol 對象轉換爲原始值。返回該原始值爲指定的 Symbol 對象。

Symbol()[Symbol.toPrimitive](hint);

通常不須要本身調用 JS 會自動地調用該方法。

Symbol 靜態屬性

除了prototype屬性，Symbol 還有一個length屬性，值爲0。