JavaScript批量将对象所有属性设为只读

先说结论：如果需要将对象的所有自有属性快速设置为只读，直接使用 Object.freeze() 是最简便的方法。但需要注意，这个方法只作用于当前层级，不会递归处理嵌套对象——换言之，只能冻结浅层结构。

下面我们详细拆解几种实现方式，并梳理一些容易忽略的坑点。

基础用法：冻结顶层对象

Object.freeze() 是最直接的方案，适用于简单的扁平对象。调用后，对象属性的 writable、configurable、enumerable 描述符都会被锁定。尝试修改属性值、新增属性或删除已有属性？在非严格模式下会静默失败，严格模式下直接抛出错误——行为非常明确。

但要记住：它只处理对象自身的属性，不会影响原型链中的属性。来看一个示例：

const obj = { a: 1, b: 2 };
Object.freeze(obj);
obj.a = 99;      // 无声无息
obj.c = 3;       // 添加失败
delete obj.b;    // 删除失败
console.log(obj); // { a: 1, b: 2 }

深层冻结：递归处理嵌套对象

当遇到嵌套对象时，例如对象内部包含子对象或数组，就需要手动递归冻结。大致思路是：先判断当前值是否为普通对象或数组（需排除 null、基本类型、Date、RegExp 等），然后对每个可遍历的自有属性递归调用冻结函数，最后再冻结当前层。

一个简洁的实现如下：

function deepFreeze(obj) {
  if (obj && typeof obj === 'object' && !Object.isFrozen(obj)) {
    Object.getOwnPropertyNames(obj).forEach(prop => {
      if (obj[prop] !== null && typeof obj[prop] === 'object') {
        deepFreeze(obj[prop]);
      }
    });
    Object.freeze(obj);
  }
  return obj;
}

使用时直接调用 deepFreeze({ a: 1, nested: { x: 2 } })，这样 nested.x 也会变得不可修改。

替代方案：用 Object.defineProperty 实现批量设置

如果希望获得更精细的控制——例如只将 writable 设为 false，但保留 configurable 为 true——那么 Object.freeze() 就略显僵硬。此时可以借助 Object.defineProperty 配合 Object.keys() 逐属性设置。

注意：Object.keys() 仅处理可枚举属性；若要覆盖不可枚举属性，则需使用 Object.getOwnPropertyNames()。下面的函数可以做到：

function makeAllReadOnly(obj) {
  Object.getOwnPropertyNames(obj).forEach(key => {
    Object.defineProperty(obj, key, {
      writable: false,
      configurable: false,
      enumerable: true // 保持原有枚举性
    });
  });
  return obj;
}

注意事项与限制

Object.freeze() 及其类似操作虽然实用，但有几个边界情况需要格外留意：

• 不能冻结不可枚举属性（symbol 属性例外——但 getOwnPropertyNames 能覆盖到，因此不算大坑）；
• 无法冻结 Proxy、Map、Set 等内置集合的内部状态——你只能冻结它们对外暴露的引用，内部数据结构仍然可能被修改；
• 冻结之后，属性值依然可以读取，方法也能正常调用。但如果方法内部修改了 this 或外部变量，冻结就无能为力了；
• 在 ES6 模块中，默认导出对象常配合 Object.freeze() 使用，目的就是确保 API 稳定，防止意外篡改。

这些细节并不复杂，但很容易被忽视。稍微留意一下，就能避免许多隐蔽的错误。