此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Object.getOwnPropertySymbols()

基线 广泛可用

自 2015年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Object.getOwnPropertySymbols() 静态方法返回一个包含给定对象所有自有 Symbol 属性的数组。

尝试一下

const object1 = {};
const a = Symbol("a");
const b = Symbol.for("b");

object1[a] = "localSymbol";
object1[b] = "globalSymbol";

const objectSymbols = Object.getOwnPropertySymbols(object1);

console.log(objectSymbols.length);
// Expected output: 2

语法

js
Object.getOwnPropertySymbols(obj)

参数

obj

要返回 Symbol 属性的对象。

返回值

在给定对象找到的所有自有 Symbol 属性的数组。

描述

Object.getOwnPropertyNames() 类似,你可以将给定对象的所有符号属性作为 Symbol 数组获取。请注意,Object.getOwnPropertyNames() 本身不包含对象的 Symbol 属性,只包含字符串属性。

因为所有的对象在初始化的时候不会包含任何自有的 Symbol 属性,除非你在对象上分配了 Symbol 属性,否则 Object.getOwnPropertySymbols() 只会返回一个空的数组。

示例

使用 Object.getOwnPropertySymbols()

js
const obj = {};
const a = Symbol("a");
const b = Symbol.for("b");

obj[a] = "localSymbol";
obj[b] = "globalSymbol";

const objectSymbols = Object.getOwnPropertySymbols(obj);

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

规范

规范
ECMAScript® 2027 Language Specification
# sec-object.getownpropertysymbols

浏览器兼容性

参见