Object.getOwnPropertyNames()

Object.getOwnPropertyNames() 静态方法返回一个数组，其中包含在给定对象中直接找到的所有属性（包括不可枚举属性，但使用 Symbol 的属性除外）。

试一试

语法

js
Object.getOwnPropertyNames(obj)

参数

obj

要返回其可枚举和不可枚举属性的对象。

返回值

一个字符串数组，对应于在给定对象中直接找到的属性。

描述

Object.getOwnPropertyNames() 返回一个数组，其元素是字符串，对应于在给定对象 obj 中直接找到的可枚举和不可枚举属性。数组中可枚举属性的顺序与 for...in 循环（或 Object.keys()）遍历对象属性时暴露的顺序一致。对象的非负整数键（可枚举和不可枚举）首先按升序添加到数组中，然后是按插入顺序排列的字符串键。

在 ES5 中，如果此方法的参数不是对象（原始值），则会导致 TypeError。在 ES2015 中，非对象参数将被强制转换为对象。

js
Object.getOwnPropertyNames("foo");
// TypeError: "foo" is not an object (ES5 code)

Object.getOwnPropertyNames("foo");
// ["0", "1", "2", "length"]  (ES2015 code)

示例

使用 Object.getOwnPropertyNames()

js
const arr = ["a", "b", "c"];
console.log(Object.getOwnPropertyNames(arr).sort());
// ["0", "1", "2", "length"]

// Array-like object
const obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.getOwnPropertyNames(obj).sort());
// ["0", "1", "2"]

Object.getOwnPropertyNames(obj).forEach((val, idx, array) => {
  console.log(`${val} -> ${obj[val]}`);
});
// 0 -> a
// 1 -> b
// 2 -> c

// non-enumerable property
const myObj = Object.create(
  {},
  {
    getFoo: {
      value() {
        return this.foo;
      },
      enumerable: false,
    },
  },
);
myObj.foo = 1;

console.log(Object.getOwnPropertyNames(myObj).sort()); // ["foo", "getFoo"]

如果您只需要可枚举属性，请参阅 Object.keys() 或使用 for...in 循环（请注意，这也会返回沿着对象原型链找到的可枚举属性，除非后者使用 Object.hasOwn() 进行过滤）。

原型链上的项未列出

js
function ParentClass() {}
ParentClass.prototype.inheritedMethod = function () {};

function ChildClass() {
  this.prop = 5;
  this.method = function () {};
}
ChildClass.prototype = new ParentClass();
ChildClass.prototype.prototypeMethod = function () {};

console.log(Object.getOwnPropertyNames(new ChildClass()));
// ["prop", "method"]

仅获取不可枚举属性

这使用 Array.prototype.filter() 函数从所有键列表（使用 Object.getOwnPropertyNames() 获取）中删除可枚举键（使用 Object.keys() 获取），从而仅输出不可枚举键。

js
const target = myObject;
const enumAndNonenum = Object.getOwnPropertyNames(target);
const enumOnly = new Set(Object.keys(target));
const nonenumOnly = enumAndNonenum.filter((key) => !enumOnly.has(key));

console.log(nonenumOnly);

规范

规范
ECMAScript 语言规范
# sec-object.getownpropertynames

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅