reflect.ownkeys仅返回对象自身第一层键名(含字符串和symbol),不递归嵌套;要获取所有层级键名需手动递归遍历,注意循环引用、类型判断及symbol保留。

Reflect.ownKeys 可以获取对象自身所有键名(包括字符串和 Symbol),但它只返回**第一层**的键,不递归。要拿到“所有层级”的键名标识(含 Symbol),必须手动递归遍历,同时注意避免循环引用、区分属性类型、保留 Symbol 的原始值。
理解 Reflect.ownKeys 的能力与局限
Reflect.ownKeys(obj) 返回一个数组,包含 obj 自身可枚举 + 不可枚举的字符串键和 Symbol 键(如 Symbol('id')),但不会进入嵌套对象或数组内部。它不处理原型链,也不展开值为对象的属性。
- ✅ 能拿到
Object.defineProperty(obj, Symbol('token'), { value: 1 })中的 Symbol 键 - ✅ 能拿到不可枚举字符串键(如通过
Object.defineProperty设置的enumerable: false) - ❌ 拿不到
obj.nested?.name中的name - ❌ 对
Array、Date、Map等内置类型,只返回其自身拥有的键(如数组的'length'和索引 Symbol,但不递归元素)
递归提取所有层级键名(含 Symbol)的核心逻辑
需手动实现深度遍历:对每个属性值判断是否为“可继续展开的对象”(plain object、array、map、set 等),再对其调用 ownKeys 并递归。关键点:
- 用
WeakMap记录已访问对象,防止循环引用死循环 - 区分
typeof value === 'object' && value !== null后,再细判是否为 plain object(Object.prototype.toString.call(value) === '[object Object]') - 对
Array,Reflect.ownKeys会返回索引字符串('0','1')和'length',也包括其自定义 Symbol 属性 - 对
Map/Set,它们自身没有可枚举/不可枚举的“键属性”,但你可以选择是否把Map.prototype.keys()视为“业务键”——这取决于你的业务定义;默认不纳入,除非显式要求
一个实用的递归提取函数示例
以下函数返回所有层级出现过的键名(去重后的数组),保留原始 Symbol 实例(非字符串描述):
function getAllKeys(obj, seen = new WeakMap()) {
if (obj === null || typeof obj !== 'object') return [];
// 防止循环引用
if (seen.has(obj)) return [];
seen.set(obj, true);
const keys = Reflect.ownKeys(obj);
const result = [...keys];
for (const key of keys) {
const val = obj[key];
if (val !== null && typeof val === 'object') {
result.push(...getAllKeys(val, seen));
}
}
return result;
}
// 使用示例:
const symA = Symbol('user-id');
const symB = Symbol('meta');
const data = {
id: 123,
[symA]: 'abc',
profile: {
name: 'Alice',
[symB]: { scope: 'read' }
}
};
console.log(getAllKeys(data));
// → ['id', Symbol(user-id), 'profile', 'name', Symbol(meta), 'scope']
业务中需特别注意的边界情况
真实业务对象常含特殊结构,提取时容易遗漏或误入:
-
Proxy 对象:Reflect.ownKeys 仍能获取其 trap 定义的 keys,但若 handler 没有实现
ownKeys,会退回到目标对象;建议先target = obj[Symbol.for('target')] || obj尝试解包 -
类实例:自有属性(含私有字段
#field)无法通过 Reflect.ownKeys 获取(私有字段不可反射),仅能拿到公共属性和 Symbol 属性 -
函数对象:函数也是对象,可能有自定义 Symbol 属性(如
fn[Symbol.toStringTag] = 'APIHandler'),应被包含 - 冻结/密封对象:不影响 Reflect.ownKeys 行为,照常返回全部自有键










