JS空对象判断：Object.keys与JSON.stringify

脚本专家

在JavaScript业务代码中，判断对象是否为空常用于参数校验、缓存命中和配置默认值处理。原文给出的首选是 Object.keys(obj).length === 0：它写法简洁，只检查自身可枚举属性，不受原型链影响，性能也较好。但使用前必须先确认 obj 不是 null 或 undefined，否则 Object.keys 会直接抛错。原文给出的健壮表达式是：

2. var obj = null;
3. var isEmpty = obj != null && Object.keys(obj).length === 0;
4. console.log(isEmpty); // false

复制代码

常用方法及边界如下：
1. Object.keys(obj).length === 0：最常用，只统计自身可枚举属性，不包含Symbol键。
2. JSON.stringify(obj) === '{}'：写法简单，但值为 undefined、函数或 Symbol 的属性会被忽略，可能误判；循环引用会直接报错。
3. for...in 配合 hasOwnProperty：for...in 能遍历到原型链上的可枚举属性，所以必须用 hasOwnProperty 过滤，代码稍繁琐。jQuery 的 $.isEmptyObject() 可视为对该思路的封装，但需要项目已引入 jQuery。
4. Object.getOwnPropertyNames(obj).length === 0：能检测不可枚举属性，比 Object.keys 更严格，但同样不包含 Symbol 键。
5. Reflect.ownKeys(obj).length === 0：最彻底，包含不可枚举属性和 Symbol 键，适合要求“绝对空”的场景，日常用得少。
6. 第三方库：如 lodash 的 _.isEmpty(obj)，适合项目已引入该库的情况。

原文示例可直接对照：

2. var data = {};
3. var b1 = Object.keys(data).length === 0;
4. console.log(b1); // true
6. var b2 = JSON.stringify(data) === '{}';
7. console.log(b2); // true
9. var b3 = (function () {
10.   for (var key in data) {
11.     return false;
12.   }
13.   return true;
14. })();
15. console.log(b3); // true
17. var b4 = Object.getOwnPropertyNames(data).length === 0;
18. console.log(b4); // true
20. var b5 = $.isEmptyObject(data);
21. console.log(b5); // true
23. var b6 = Reflect.ownKeys(data).length === 0;
24. console.log(b6); // true

复制代码

关键注意点：判断前先排除 null 和 undefined；如果对象里可能只有 Symbol 属性，Object.keys、JSON.stringify、for...in 都会失效，只有 Reflect.ownKeys 能正确识别。原文的建议很明确：日常业务用 Object.keys 就够，追求严格空再用 Reflect.ownKeys，不必过度设计。

JSON.stringify 的语法为 JSON.stringify(value[, replacer[, space]])。value 是必需项，通常为对象或数组；replacer 可选，为函数时逐成员调用并用返回值替换原值，返回 undefined 会排除该成员，为数组时只转换数组中具有键值的成员；space 可选，用于缩进和换行，数字大于10时按10个空格处理，也可使用 \t 等非数字字符。返回值是包含 JSON 文本的字符串。原文列出的序列化特性，直接影响判空和深拷贝：

1. undefined、任意函数和 Symbol 作为对象属性值时会被跳过；作为数组元素值时会被序列化为 null；作为单独值序列化时返回 undefined。

2. var data = {
3.   a: 'aaa',
4.   b: undefined,
5.   c: Symbol('dd'),
6.   fn: function () { return true; }
7. };
8. console.log(JSON.stringify(data)); // 输出结果只保留 a 属性

复制代码

2. 非数组对象的属性不能保证以特定顺序出现在序列化后的字符串中，数组除外。
3. 转换值如果有 toJSON() 函数，该函数返回什么值，序列化结果就是什么值，并忽略其他属性。
4. Date 值会被正常序列化。
5. NaN 和 Infinity 格式的数值及 null 都会被当做 null。
6. 布尔值、数字、字符串的包装对象在序列化过程中会自动转换成对应的原始值。
7. 其他类型的对象，包括 Map/Set/WeakMap/WeakSet，仅会序列化可枚举的属性。
8. 用 JSON.parse(JSON.stringify()) 做深拷贝时，循环引用会抛出错误。原文示例的错误类型为 TypeError: Converting circular structure to JSON。

2. const obj = { name: 'loopObj' };
3. const loopObj = { obj: obj };
4. obj.loopObj = loopObj;
5. function deepClone(value) {
6.   return JSON.parse(JSON.stringify(value));
7. }
8. deepClone(obj);
9. // TypeError: Converting circular structure to JSON

复制代码

综上，判空优先用 Object.keys 并先做空值保护；需要把不可枚举属性和 Symbol 键也纳入时，改用 Reflect.ownKeys。JSON.stringify 写法短，但因会忽略 undefined、函数和 Symbol 属性，还存在循环引用报错问题，不适合作为唯一判空依据。

热心网友6

总结得挺到位的，Object.keys 做日常判空确实够用，那个 obj != null 的写法也很实用——宽松相等能同时把 null 和 undefined 挡掉，比分别写 !== null && !== undefined 省事，也不容易漏。 补充一个小坑：如果入参类型不确定，光排除 null 和 undefined 还不够，Object.keys 对原始值的行为有点迷惑，比如 Object.keys(1) 返回空数组、Object.keys('') 也返回空数组，放进判空逻辑里就会把数字或字符串误当成空对象。所以工具函数里最好再加一层 typeof obj === 'object' 或者 Object.prototype.toString 的判断，尤其是参数从接口或配置里透传过来的时候。 Symbol 键那段也很关键，之前用 Symbol 做事件名缓存 key 就踩过，Object.keys 和 JSON.stringify 都看不见，最后换成 Reflect.ownKeys 才对上。 JSON.stringify 的细节列得很清楚，数组里 undefined 和函数变 null 这条最容易被忽略，还有 toJSON 会覆盖整个序列化结果，跟 Date 那条其实是同一个机制。拿它做深拷贝确实只适合纯数据场景。

热心网友5

这篇整理得挺清楚，日常业务里用 Object.keys(obj).length === 0 确实够用，关键是判断前先把 null 和 undefined 排除掉，写成 obj != null && Object.keys(obj).length === 0 这种保护形式比较稳妥。JSON.stringify 虽然短，但遇到 undefined、函数、Symbol 属性以及循环引用时确实容易踩坑，不适合当唯一判空依据。如果配置对象可能带 Symbol 键或不可枚举属性，再换 Reflect.ownKeys 更安心。整体建议很实用，感谢分享。

热心网友7

楼主的整理挺系统的，尤其是把 Symbol 键这个容易踩的坑单独点出来，很有价值。补充几个自己在实际业务里遇到的小细节，供参考。 一是示例里那个 for...in 的写法，判断空对象时确实没问题，但如果对象本身没有属性、原型链上却被扩展了可枚举属性（老项目里挺常见），它就会误判成“非空”。所以真要用手写循环，还是得像楼主正文说的那样加上 hasOwnProperty 过滤，最好写成 Object.prototype.hasOwnProperty.call(obj, key)，避免对象是用 Object.create(null) 创建出来的、自身没有 hasOwnProperty 方法导致报错。 二是 Object.keys 对数组也会返回下标索引，所以空数组 [] 会被判成“空”，如果参数校验里对象和数组都走同一个入口，最好先 Array.isArray 区分一下，不然可能把空数组当空对象放过去。 三是如果工程里已经能用较新的语法，其实也可以直接用 Object.hasOwn 或者配合 Reflect.ownKeys 封一个 isEmptyObject 工具函数统一处理 null/undefined 和 Symbol，业务里只调这一个，省的每个地方都要重复写 obj != null &&。判空逻辑一旦分散，后面加规则很容易漏改。 整体上很认同楼主最后那句：日常 Object.key