如何通过 Object.isFrozen 判断全局单例是否进入只读安全状态？

本文共计647个文字，预计阅读时间需要3分钟。

`Object.isFrozen` 不能用来判断全局单例状态是否处于‘只读安全期’——它只能检测一个对象是否被 `frozen`（即不可扩展、不可配置、所有属性不可写）。但只读安全期是一个业务语义概念，不是 JavaScript 引擎定义的运行时状态。

Object.isFrozen 的真实作用

它仅检查对象是否满足以下全部条件：

• Object.isExtensible(obj) === false
• 所有自有属性的 configurable 为 false
• 所有自有数据属性的 writable 为 false

注意：它不关心对象是否被“逻辑上冻结”，也不感知模块初始化阶段、是否完成配置、是否有并发写入风险等。即使一个单例对象已被 freeze，若其属性值是引用类型（如数组、嵌套对象），这些内部值仍可被修改。

为什么不能直接用于“只读安全期”判定

“只读安全期”通常指：单例已完成初始化、外部不再允许修改、且当前处于稳定服务阶段。这涉及：

• 初始化流程是否结束（如构造函数执行完、依赖注入完成）
• 是否有运行时开关控制可写性（如 isLocked 标志）
• 是否在多线程/异步上下文中存在竞态（Object.isFrozen 不提供同步保障）
• 是否深冻结（Object.isFrozen 只检测浅层）

更实用的替代方案

若需表达和校验“只读安全期”，推荐组合方式：

• 显式设置一个私有状态标志，例如 _frozenAt = Date.now() 或 _lifecycle = 'frozen'
• 封装 setter 方法，在写入前检查该标志：if (this._lifecycle !== 'frozen') { /* allow */ }
• 配合 Object.freeze(this) 做浅层防护，并在 freeze 前确保初始化完毕
• 对关键嵌套结构使用深冻结工具（如 immer 的 freeze 或自定义递归 freeze 函数）

一个轻量示例

```js
class Singleton {
  constructor() {
    this._lifecycle = 'initializing';
    // ... 初始化逻辑
    this._lifecycle = 'frozen';
    Object.freeze(this);
  }
  get isReadOnlySafe() {
    return this._lifecycle === 'frozen';
  }
}
```

此时应优先用 instance.isReadOnlySafe 判断业务意义上的“只读安全期”，而非 Object.isFrozen(instance)。