1. 主页
  2. 文档
  3. 君土参考手册
  4. 标准内置对象
  5. 符号(Symbol)

符号(Symbol)

符号(symbol) 是一种基本数据类型 (primitive data type)。符号()(Symbol)函数会返回(symbol)类型的值,该类型具有静态属性和静态方法。它的静态属性会暴露几个内建的成员对象;它的静态方法会暴露全局的符号(symbol)注册,且类似于内建对象类,但作为构造函数来说它并不完整,因为它不支持语法:”符号()“。

每个从符号()(Symbol)返回的(symbol)值都是唯一的。一个(symbol)值能作为对象属性的标识符;这是该数据类型仅有的目的。更进一步的解析见—— glossary entry for Symbol。

常 符1 = 符号();
常 符2 = 符号(42);
常 符3 = 符号('符');

控制台.日志(样 符1);
// 期望输出: 符("symbol")

控制台.日志(符2 === 42);
// 期望输出: 假(false)

控制台.日志(符3.字串());
// 期望输出: Symbol(符)

控制台.日志(符号('符') === 符号('符'));
// 期望输出: 假(false)

语法

符号([描述])

参数

描述 可选可选的,字符串类型。对(symbol)的描述,可用于调试但不是访问(symbol)本身。

描述

直接使用符号()(Symbol)创建新的(symbol)类型,并用一个可选的字符串作为其描述。

定 符1 = 符号();
定 符2 = 符号('符');
定 符3 = 符号('符');

上面的代码创建了三个新的(symbol)类型。 注意,Symbol("foo") 不会强制将字符串 “foo” 转换成(symbol)类型。它每次都会创建一个新的 (symbol)类型:

符号("符") === 符号("符"); // 假

下面带有 启(new) 运算符的语法将抛出 种错(TypeError) 错误:

定 符_ = 启 符号(); // 种错

这会阻止创建一个显式的 符号(Symbol) 包装器对象而不是一个 符号(Symbol) 值。围绕原始数据类型创建一个显式包装器对象从 ECMAScript 6 开始不再被支持。 然而,现有的原始包装器对象,如 启 布尔(Boolean) 字串(String)以及 数字(Number),因为遗留原因仍可被创建。

如果你真的想创建一个 符号(Symbol )包装器对象 (Symbol wrapper object),你可以使用 对象()(Object) 函数:

定 符_ = 符号("foo");
样 符_;     // "symbol":符
定 符象 = 对象(符_);
样 符象;  // "object":象

全局共享的 Symbol

上面使用Symbol() 函数的语法,不会在你的整个代码库中创建一个可用的全局?symbol类型。 要创建跨文件可用的symbol,甚至跨域(每个都有它自己的全局作用域) , 使用 Symbol.for() 方法和  Symbol.keyFor() 方法从全局的symbol注册?表设置和取得symbol。

在对象中查找 Symbol 属性

Object.getOwnPropertySymbols() 方法让你在查找一个给定对象的符号属性时返回一个?symbol类型的数组。注意,每个初始化的对象都是没有自己的symbol属性的,因此这个数组可能为空,除非你已经在对象上设置了symbol属性。

属性

符号.长 – Symbol.length
长度属性,值为0。

符号.原型 – Symbol.prototype
symbol构造函数的原型。

众所周知的符号( symbols)

除了自己创建的symbol,JavaScript还内建了一些在ECMAScript 5 之前没有暴露给开发者的symbol,它们代表了内部语言行为。它们可以使用以下属性访问:

迭代符号( symbols)

符号.迭代器 – Symbol.iterator
一个返回一个对象默认迭代器的方法。被 for...of 使用。

符号.途迭代器 – Symbol.asyncIterator
 一个返回对象默认的异步迭代器的方法。被 for await of 使用。

正则表达式 symbols

符号.配 – Symbol.match
一个用于对字符串进行匹配的方法,也用于确定一个对象是否可以作为正则表达式使用。被 String.prototype.match() 使用。

符号.替 – Symbol.replace
一个替换匹配字符串的子串的方法. 被 String.prototype.replace() 使用。

符号.查 – Symbol.search
一个返回一个字符串中与正则表达式相匹配的索引的方法。被String.prototype.search() 使用。

符号.分 – Symbol.split
一个在匹配正则表达式的索引处拆分一个字符串的方法.。被 String.prototype.split() 使用。

其他 symbols

符号.有实例 – Symbol.hasInstance
一个确定一个构造器对象识别的对象是否为它的实例的方法。被 instanceof 使用。

符号.可接展 – Symbol.isConcatSpreadable
一个布尔值,表明一个对象是否应该flattened为它的数组元素。被 Array.prototype.concat() 使用。

符号.排除 – Symbol.unscopables
拥有和继承属性名的一个对象的值被排除在与环境绑定的相关对象外。

符号. 种 – Symbol.species
一个用于创建派生对象的构造器函数。

符号.基型 – Symbol.toPrimitive
一个将对象转化为基本数据类型的方法。

符号.字串签 – Symbol.toStringTag
用于对象的默认描述的字符串值。被 Object.prototype.toString() 使用。

方法

符号.为(键) – Symbol.for(key)
使用给定的key搜索现有的symbol,如果找到则返回该symbol。否则将使用给定的key在全局symbol注册表中创建一个新的symbol。

符号.键为(符) – Symbol.keyFor(sym)
从全局符号(symbol)注册表中,为给定的符号(symbol)检索一个共享的符号(symbol) 键(key)。

Symbol 原型

所有 Symbols 继承自 Symbol.prototype.

属性

Symbol.prototype.constructor
返回创建实例原型的函数. 默认为 Symbol 函数。

Symbol.prototype.description
一个包含symbol描述的只读字符串。

方法

源码() – Symbol.prototype.toSource()
 返回包含Symbol 对象源码的字符串。覆盖Object.prototype.toSource() 方法。

转字() – Symbol.prototype.toString()
返回包含Symbol描述符的字符串。 覆盖Object.prototype.toString() 方法。

原值() – Symbol.prototype.valueOf()
返回 Symbol 对象的初始值.。覆盖 Object.prototype.valueOf() 方法。

Symbol.prototype[@@toPrimitive] 
返回Symbol对象的初始值。

示例

对 symbol 使用 typeof 运算符

 typeof运算符能帮助你识别 symbol 类型

typeof Symbol() === 'symbol'
typeof Symbol('foo') === 'symbol'
typeof Symbol.iterator === 'symbol'

Symbol 类型转换

当使用 symbol 值进行类型转换时需要注意一些事情:

  • 尝试将一个 symbol 值转换为一个 number 值时,会抛出一个 TypeError 错误  (e.g. +sym or sym | 0).
  • 使用宽松相等时, Object(sym) == sym returns true.
  • 这会阻止你从一个 symbol 值隐式地创建一个新的 string 类型的属性名。例如,Symbol("foo") + "bar" 将抛出一个 TypeError (can’t convert symbol to string).
  • “safer” String(sym) conversion 的作用会像symbol类型调用 Symbol.prototype.toString() 一样,但是注意 new String(sym) 将抛出异常。

Symbols 与 for...in 迭代

Symbols 在 for...in 迭代中不可枚举。另外,Object.getOwnPropertyNames() 不会返回 symbol 对象的属性,但是你能使用 Object.getOwnPropertySymbols() 得到它们。

var obj = {};

obj[Symbol("a")] = "a";
obj[Symbol.for("b")] = "b";
obj["c"] = "c";
obj.d = "d";

for (var i in obj) {
   console.log(i); // logs "c" and "d"
}

Symbols 与 JSON.stringify()

当使用 JSON.stringify() 时,以 symbol 值作为键的属性会被完全忽略:

JSON.stringify({[Symbol("foo")]: "foo"});                 
// '{}'

更多细节,请看 JSON.stringify()

Symbol 包装器对象作为属性的键

当一个 Symbol 包装器对象作为一个属性的键时,这个对象将被强制转换为它包装过的 symbol 值:

var sym = Symbol("foo");
var obj = {[sym]: 1};
obj[sym];            // 1
obj[Object(sym)];    // still 1

原始MDN文档