在此页

• 句法
• 描述
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Object.getOwnPropertyNames() method returns an array of all properties (including non-enumerable properties except for those which use Symbol) found directly in a given object.

句法

Object.getOwnPropertyNames(obj)
					

参数

obj

The object whose enumerable and non-enumerable properties are to be returned.

返回值

An array of strings that corresponds to the properties found directly in the given object.

描述

Object.getOwnPropertyNames() returns an array whose elements are strings corresponding to the enumerable and non-enumerable properties found directly in a given object obj . The ordering of the enumerable properties in the array is consistent with the ordering exposed by a for...in loop (or by Object.keys() ) over the properties of the object. The ordering of the non-enumerable properties in the array and the ordering among the enumerable properties is not defined.

In ES5, if the argument to this method is not an object (a primitive), then it will cause a TypeError . In ES2015, a non-object argument will be coerced to an object.

Object.getOwnPropertyNames('foo');
// TypeError: "foo" is not an object (ES5 code)
Object.getOwnPropertyNames('foo');
// ["0", "1", "2", "length"]  (ES2015 code)
					

范例

使用 Object.getOwnPropertyNames()

var arr = ['a', 'b', 'c'];
console.log(Object.getOwnPropertyNames(arr).sort()); // .sort() is an array method.
// logs ["0", "1", "2", "length"]
// Array-like object
var obj = { 0: 'a', 1: 'b', 2: 'c' };
console.log(Object.getOwnPropertyNames(obj).sort()); // .sort() is an array method.
// logs ["0", "1", "2"]
// Logging property names and values using Array.forEach
Object.getOwnPropertyNames(obj).forEach(
  function (val, idx, array) {
    console.log(val + ' -> ' + obj[val]);
  }
);
// logs
// 0 -> a
// 1 -> b
// 2 -> c
// non-enumerable property
var my_obj = Object.create({}, {
  getFoo: {
    value: function() { return this.foo; },
    enumerable: false
  }
});
my_obj.foo = 1;
console.log(Object.getOwnPropertyNames(my_obj).sort());
// logs ["foo", "getFoo"]
					

If you want only the enumerable properties, see Object.keys() or use a for...in loop (note that this will also return enumerable properties found along the prototype chain for the object unless the latter is filtered with hasOwnProperty() ).

Items on the prototype chain are not listed:

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"]
  )
);
					

Get non-enumerable properties only

This uses the Array.prototype.filter() function to remove the enumerable keys (obtained with Object.keys() ) from a list of all keys (obtained with Object.getOwnPropertyNames() ) thus giving only the non-enumerable keys as output.

var target = myObject;
var enum_and_nonenum = Object.getOwnPropertyNames(target);
var enum_only = Object.keys(target);
var nonenum_only = enum_and_nonenum.filter(function(key) {
  var indexInEnum = enum_only.indexOf(key);
  if (indexInEnum == -1) {
    // Not found in enum_only keys,
    // meaning that the key is non-enumerable,
    // so return true so we keep this in the filter
    return true;
  } else {
    return false;
  }
});
console.log(nonenum_only);
					

规范

规范
ECMAScript (ECMA-262) The definition of 'Object.getOwnPropertyNames' in that specification.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
getOwnPropertyNames	Chrome 5	Edge 12	Firefox 4	IE 9	Opera 12	Safari 5	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 12	Safari iOS 5	Samsung Internet Android 1.0	nodejs Yes

图例

完整支持

完整支持

另请参阅

• Enumerability and ownership of properties
• Object.prototype.hasOwnProperty()
• Object.prototype.propertyIsEnumerable()
• Object.create()
• Object.keys()
• Array.forEach()

元数据

• 最后修改： May 21, 2020

相关话题

1. 标准内置对象
2. Object
3. 特性
   1. Object.prototype.__proto__
   2. Object.prototype.constructor
4. 方法
   1. Object.assign()
   2. Object.create()
   3. Object.defineProperties()
   4. Object.defineProperty()
   5. Object.entries()
   6. Object.freeze()
   7. Object.fromEntries()
   8. Object.getOwnPropertyDescriptor()
   9. Object.getOwnPropertyDescriptors()
   10. Object.getOwnPropertyNames()
   11. Object.getOwnPropertySymbols()
   12. Object.getPrototypeOf()
   13. Object.is()
   14. Object.isExtensible()
   15. Object.isFrozen()
   16. Object.isSealed()
   17. Object.keys()
   18. Object.preventExtensions()
   19. Object.prototype.__defineGetter__()
   20. Object.prototype.__defineSetter__()
   21. Object.prototype.__lookupGetter__()
   22. Object.prototype.__lookupSetter__()
   23. Object.prototype.hasOwnProperty()
   24. Object.prototype.isPrototypeOf()
   25. Object.prototype.propertyIsEnumerable()
   26. Object.prototype.toLocaleString()
   27. Object.prototype.toSource()
   28. Object.prototype.toString()
   29. Object.prototype.valueOf()
   30. Object.seal()
   31. Object.setPrototypeOf()
   32. Object.values()
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()