reflect.ownkeys 返回对象所有自有属性的字符串和 symbol 键,不包括私有字段(#);等价于 object.getownpropertynames 与 object.getownpropertysymbols 的合并结果,顺序为先字符串后 symbol。

Reflect.ownKeys 可以获取对象**所有类型的自有属性键名(包括字符串、Symbol 和私有字段前的 #)**,但要注意:它**只返回字符串和 Symbol 类型的键,不返回私有字段(#field)**——因为私有字段在 JavaScript 中不属于“可枚举或可遍历的自有属性”,而是语法层面的访问控制机制,根本不会出现在属性键列表中。
能拿到哪些键?
Reflect.ownKeys(obj) 返回一个数组,包含对象 所有自有属性的键名,无论是否可枚举、是否为 Symbol,只要它是该对象自己拥有的(不是继承的),就会被列出:
- 字符串键(包括空字符串、数字字符串如 "0"、"1.5"、"constructor" 等)
- Symbol 键(如 Symbol("id")、Symbol.iterator)
- 不包括原型链上的任何键(如 Object.prototype.toString)
- 不包括私有字段(#name、#id),它们不是“属性键”,无法通过 Reflect.ownKeys、Object.keys、for...in 等任何反射 API 访问
和 Object.getOwnPropertyNames / Object.getOwnPropertySymbols 的区别
Reflect.ownKeys 是这两者的**合并结果(顺序是:先字符串键,再 Symbol 键)**,且更底层、更完整:
- Object.getOwnPropertyNames(obj):只返回字符串类型的自有属性名
- Object.getOwnPropertySymbols(obj):只返回 Symbol 类型的自有属性名
-
Reflect.ownKeys(obj):等价于
[...Object.getOwnPropertyNames(obj), ...Object.getOwnPropertySymbols(obj)],但语义更统一,且是 ES6 标准反射 API 的一部分
实际用法示例
以下代码演示它如何捕获混合类型键:
const sym1 = Symbol('a');
const sym2 = Symbol('b');
const obj = {
foo: 1,
'0': 'zero',
'': 'empty',
[sym1]: 'symbol value',
[sym2]: 42
};
// 添加不可枚举属性
Object.defineProperty(obj, 'hidden', {
value: 'secret',
enumerable: false
});
console.log(Reflect.ownKeys(obj));
// → ['foo', '0', '', Symbol(a), Symbol(b), 'hidden']
// 注意:'hidden' 虽不可枚举,但仍是自有属性,所以会被包含
注意事项
- 对 null 或 undefined 调用会抛出 TypeError,使用前建议校验
- 对原始值(如字符串、数字)会自动装箱,返回其包装对象的自有键(例如 Reflect.ownKeys("abc") 返回 ['0', '1', '2', 'length'])
- 不能获取 getter/setter 的键名本身(它能获取,但不会区分属性描述符类型;要判断是否为 accessor,需配合 Object.getOwnPropertyDescriptor)
- 不反映 Proxy 的 trap 行为——如果目标是 Proxy,Reflect.ownKeys 触发的是 handler.ownKeys(),你可以自定义返回值
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











