Reflect.ownKeys()获取对象所有自有键名

Reflect.ownKeys() 是 JavaScript 中唯一能一次性、无遗漏地获取对象所有自有属性键（包括可枚举/不可枚举的字符串键和 Symbol 键）的可靠方法，严格按创建顺序返回 (string | symbol)[] 类型数组，完美替代繁琐且类型不安全的 Object.getOwnPropertyNames() 与 Object.getOwnPropertySymbols() 手动拼接；它不关心枚举性，只聚焦“物理存在”，因此成为处理元数据（如 Symbol.metadata）、深拷贝含 Symbol 对象、规避 for...in 或 JSON.stringify 信息丢失等实际场景的关键工具，但需注意其对 WeakMap/WeakSet 抛错及 Proxy 对象的潜在限制。

Reflect.ownKeys() 确实能拿到 Symbol 键，但得确保 Symbol 是“自有”的

它不会漏掉 Symbol 类型的键，前提是这些 Symbol 是直接定义在目标对象上、而非继承来的。比如 obj[Symbol('a')] = 1 会进结果，但 Object.prototype[Symbol.toStringTag] 不会——因为那是原型链上的。

常见错误是误以为 Reflect.ownKeys() 会返回所有 Symbol（包括全局注册的或内置的），其实它只管“自有 + 可枚举/不可枚举 + 字符串/Symbol”，和 Object.getOwnPropertyNames() + Object.getOwnPropertySymbols() 的并集等价。

• Reflect.ownKeys() 返回的是 Array，顺序是：先字符串键（按创建顺序），再 Symbol 键（也按创建顺序）
• 如果对象有 Symbol.for('x') 和 Symbol('x') 两个不同 Symbol，它们都会被列出，互不影响
• 注意：WeakMap、WeakSet 等无法遍历内部键，Reflect.ownKeys() 对它们抛 TypeError

对比 Object.keys() / Object.getOwnPropertyNames() 容易踩的坑

Object.keys() 只返回可枚举的字符串键；Object.getOwnPropertyNames() 返回所有自有字符串键（含不可枚举），但完全忽略 Symbol；只有 Reflect.ownKeys() 或 Object.getOwnPropertyNames() + Object.getOwnPropertySymbols() 组合才能覆盖全量。

典型翻车场景：你用 for...in 或 Object.keys() 遍历配置对象，结果漏掉了 obj[Symbol.metadata] = {...} 这种元数据键，后续序列化或深拷贝就丢信息。

• 别用 Object.keys(obj).concat(Object.getOwnPropertySymbols(obj)) ——类型不一致（前者是 string[]，后者是 symbol[]），合并后数组元素类型变成 (string | symbol)[]，TypeScript 会报错，运行时虽可行但不干净
• 直接用 Reflect.ownKeys(obj) 最省心，语义明确，且返回值类型就是 (string | symbol)[]
• 如果要过滤出纯 Symbol 键，用 Reflect.ownKeys(obj).filter(k => typeof k === 'symbol')

Symbol 键不可枚举，但 Reflect.ownKeys() 不care枚举性

这是关键点：Reflect.ownKeys() 不区分可枚举/不可枚举，它只认“是否为自有属性”。所以即使你用 Object.defineProperty(obj, 'hidden', { value: 1, enumerable: false }) 加了不可枚举字符串键，或者用 obj[Symbol.iterator] = function*(){} 加了不可枚举 Symbol 键，它全收。

这也意味着：不能靠 Reflect.ownKeys() 判断某个键是否“应该被 JSON.stringify() 包含”——因为 JSON.stringify() 只处理可枚举的字符串键，对 Symbol 和不可枚举键一律无视。

• Reflect.ownKeys() 是反射层面的“物理存在性”探测，不是运行时行为控制工具
• 想模拟 JSON.stringify() 行为？得手动筛：Reflect.ownKeys(obj).filter(k => typeof k === 'string' && obj.propertyIsEnumerable(k))
• 给 Symbol 键设 enumerable: false 没意义——Symbol 键天生不可枚举，propertyIsEnumerable() 对任何 Symbol 键都返回 false

实际用法示例：安全地遍历并克隆含 Symbol 的对象

很多库（比如 Vue 的响应式标记、class 装饰器元数据）依赖 Symbol 属性，直接 Object.assign({}, obj) 或展开运算符会丢失它们。

const source = {
  a: 1,
  b: 2
};
source[Symbol.for('meta')] = { version: 2 };
source[Symbol('id')] = 'xyz';

const clone = {};
Reflect.ownKeys(source).forEach(key => {
  clone[key] = source[key];
});
// clone 现在有 a、b、Symbol.for('meta')、Symbol('id') 四个键

注意：这样浅拷贝没问题，但如果 Symbol 键对应的是复杂对象，且你希望深拷贝，就得额外判断 typeof key === 'symbol' 并递归处理值——这点常被忽略。

真正麻烦的是那些带 [[DefineOwnProperty]] 陷阱的对象（比如 Proxy），Reflect.ownKeys() 返回的键可能和实际可访问的不一致，此时需结合 Reflect.getOwnPropertyDescriptor() 进一步验证。

今天关于《Reflect.ownKeys()获取对象所有自有键名》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！