JavaScriptのSymbolとは？

先日、O'Reillyから出版されている「JavaScript 第7版」を読んでいると見慣れぬプロパティを見つけました。

それが **Symbol** です。

文字列ではないプロパティとしてES6から導入されたもののようで、
今まで見たことがありませんでした。

今回はSymbolとは一体何なのか、
どのように使用するのかを調べてまとめてみました。

# Symbolとは
Symbolとは何なのか、まずは「[MDN Web Docs](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol)」を確認してみました。

> JavaScriptでは、シンボルはプリミティブ値です。

> Symbol データ型を持つ値は「シンボル値」として見ることができます。 JavaScript の実行時環境では、シンボル値は Symbol 関数を呼び出すことで生成され、動的に無名の一意の値を生み出します。シンボルはオブジェクトプロパティとして使用されることがあります。

> Symbol は任意で説明文を持つことができますが、これはデバッグ目的のみに利用されます。

いまいち分からないので、サンプルを見てみます。
```JS
let Sym1 = Symbol("Sym");
let Sym2 = Symbol("Sym");

console.log(Sym1 === Sym2); // falseを返す
```
なるほど。
一意の値を表すので、中身の説明文（値）が同じでも判定は``false``になるのか。
<br>

> JavaScript の大部分の値は文字列への暗黙的な変換に対応しています。例えば alert はほぼすべての値で表示することができ、動作します。シンボルは特殊です。自動変換は行われません。
```JS
let Sym = Symbol("Sym");

alert(Sym); // TypeError: Cannot convert a Symbol value to a string
alert(Sym.toString()); // Symbol(Sys)
```
``Symbol()``関数に文字列の引数を渡した場合、``toString()``メソッドを使用することでシンボルを表示することができるようです。
<br>
```JS
let Sym = Symbol("Sym");

alert(Sym.description); // Sys
```
そして文字列の値を参照したい場合は、``description``というプロパティを使うようです。

``Symbol()``は**一意の値を生み出す**というのがメリットのようです。

# グローバルシンボルレジストリー
``Symbol()``に対し、同じ文字列を使って呼び出した場合、常に同じ値を返す``Symbol.for()``および``Symbol.keyFor()``という関数があります。

> グローバルシンボルレジストリーを扱うメソッドは Symbol.for() および Symbol.keyFor() があります。これらは、グローバルシンボルテーブル（または「レジストリー」）と実行時環境の間を仲介します。シンボルレジストリーは、主に JavaScript コンパイラーインフラストラクチャが構築しており、その中のシンボルの内容は、 JavaScript 実行時インフラストラクチャでは上記のメソッド以外で扱えません。

> Symbol.for(tokenString)はレジストリー内のシンボル値を返し、
Symbol.keyFor(symbolValue)はレジストリーからトークンの文字列を返します。

```JS
let s = Symbol.for("sample");
let t = Symbol.for("sample");

console.log(s === t); // ture
s.toString(); // Symbol(sample)
Symbol.keyFor(t); // sample
```

``Symbol.for()``の場合、tokenStringが同じの場合は、同じ値を返します。

では実際、これらをどのように使用すればよいでのでしょうか。

# 使い方
### プロパティキーとして使用する

``Symbol()``は、オブジェクトのプロパティキーとして使用することができます。

```JS
const lunch = Symbol();
const order = Symbol();

const obj = {
    lunch: "オムライス", //  lunchという名のプロパティ
    [lunch]: "カレーライス", // シンボル値lunchのプロパティ

    order: function(){ console.log( this.lunch + "を1つお願いします。" ) },
    [order]: function(){ console.log( this[lunch] + "を1つお願いします。" ) },
}

console.log( obj.lunch ); //オムライス
console.log( obj[lunch] ); //カレーライス

obj.order(); //オムライスを1つお願いします。
obj[order](); //カレーライスを1つお願いします。
```
プロパティのキーとして利用する場合、下記のメリットがあります。
* キーの衝突の回避
* 改変などをされるリスクの低減

<br>

また、プロパティを表示したくない場合、``Symbol()``を使うことでキーを隠蔽することができます。
下記の例では、キーである「wordCount」「javascript」ともに表示されています。

```JS
const dictionary = {
    wordCount: 1,
    javascript: "a programming language..."
};

Object.keys(dictionary); // Array["wordCount", "javascript"]
```
しかし、``Symbol()``を使用する場合と下記のようになります。
```JS
const wordCountSymbol = Symbol('dictionaryWordCount');

const dictionary = {
    [wordCountSymbol]: 1,
    javascript: "a programming language..."
};

Object.keys(dictionary); // Array["javascript"]
```

このように、``Symbol()``を使用すると``Object.keys()``では表示されません。

<br>

と思ったのですが、実は``Reflect.ownKeys()``を使用することで``Symbol()``のキーでも表示できてしまうようです。。。

```JS
const wordCountSymbol = Symbol('dictionaryWordCount');

const dictionary = {
    [wordCountSymbol]: 1,
    javascript: "a programming language..."
};

console.log(Reflect.ownKeys(dictionary)); 
// [Symbol('dictionaryWordCount'), "javascript"]
```

# 導入の理由
名前の衝突を避けたり、隠蔽したいだけならわざわざ``Symbol()``を使用しなくても回避することは可能です。

ではなぜES6で導入されたのでしょうか。
詳しい理由が下記の記事で説明されています。

https://qiita.com/naruto/items/312adeb6145eb6221be7

どうやら「**互換性**」が``Symbol()``導入の理由のようです。

例えば、既存のメソッドと同じ名前のメソッドを使用してしまうと、実装しているプログラムに影響を与えてしまいます。

しかし``Symbol()``を使用した場合、メソッドを一意の値で識別することができるため、メソッド名の重複を気にせずに拡張することができます。

```JS:hobby1.js
const hobby = Symbol("hobby");

String.prototype[hobby] = function() {
    console.log("My hobby is" + this);
}

export {hobby as default};
```


```JS:hobby2.js
const hobby = Symbol("hobby");

String.prototype[hobby] = function() {
    console.log("My hobby is" + this + "★");
}

export {hobby as default};
```

```JS:sample.js
import hobby1 from "./hobby1.js"; 
import hobby1 from "./hobby2.js";

"counting stars"[hobby1](); // My hobby is counting stars
"counting stars"[hobby2](); // My hobby is counting stars★
```

# 最後に

正直、頻繁に使用することはないかなという印象を受けました。

今回紹介した使用方法以外に、
便利な使用方法があれば教えてください。

それでは。

# 参考サイト
https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol

https://note.affi-sapo-sv.com/js-symbol.php

https://medium.com/intrinsic-blog/javascript-symbols-but-why-6b02768f4a5c

https://www.tohoho-web.com/js/symbol.htm