如何使用 await 机制配合 Object.freeze 打造在异步执行完毕后不可篡改的状态实体

雨杰同学_6792

雨杰同学_6792

2026-06-26

705人浏览

原创

不能直接用 await 配合 object.freeze 冻结异步结果,必须先 await 获取值再调用 object.freeze;需确保值为非 null 对象,冻结后返回原引用,且仅浅冻结,深度冻结需额外处理。

如何使用 await 机制配合 object.freeze 打造在异步执行完毕后不可篡改的状态实体

不能直接用 await 配合 Object.freeze “冻结异步结果”,因为 await 是运行时行为,Object.freeze 是同步操作——你只能在异步值**拿到之后**再冻结它,而非“自动冻结未来值”。关键在于时机控制和封装逻辑,而非语法联动。

先 await 拿到值,再 freeze —— 最简可靠方式

这是最直观、无陷阱的做法:等待 Promise 解析完成,得到具体对象后,立即冻结。

  • 确保异步操作返回的是普通对象(非 Proxy、类实例等),否则冻结可能不彻底
  • 冻结前检查是否为 object 类型且非 null,避免对 primitive 或 null 调用 freeze 报错
  • 冻结后返回的仍是原对象(freeze 返回原引用),可链式使用

示例:

javascript-pro
javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家,适用于现代开发

下载
async function fetchUser() {
  const res = await fetch('/api/user');
  const user = await res.json();
  return Object.freeze(user); // ✅ 冻结已解析的对象
}

// 使用
const user = await fetchUser();
user.name = 'hacker'; // ❌ 严格模式下报错,非严格模式静默失败

封装成可复用的冻结工具函数

把“await + freeze”逻辑收拢,提升可读性和复用性,尤其适合多处需要冻结异步结果的场景。

  • 函数接收一个 Promise,返回一个 Promise,其 resolve 值是冻结后的对象
  • 支持泛型或类型推导(TypeScript 下更安全)
  • 可选加入浅冻结判断,避免重复 freeze 已冻结对象

示例:

async function freezeAsync<t>(promise: Promise<t>): Promise<readonly>> {
  const value = await promise;
  if (value && typeof value === 'object') {
    Object.freeze(value);
  }
  return value as Readonly<t>;
}

// 使用
const config = await freezeAsync(fetch('/config').then(r => r.json()));
// config 现在是 readonly,编辑器和 TS 会提示不可赋值
</t></readonly></t></t>

配合 class 构造不可变状态实体

若需更强语义(如明确区分“加载中/成功/失败”),可用 class 封装状态 + 冻结 payload,同时屏蔽 setter。

  • 构造函数内 await 并 freeze 数据,内部属性设为 private
  • 只暴露 getter,不提供修改接口
  • 冻结发生在实例化完成时,保证外部拿到的就是终态不可变对象

示例:

class FrozenState<t> {
  #data: Readonly<t>;
  constructor(promise: Promise<t>) {
    this.#data = Object.freeze(await promise);
  }
  get data() { return this.#data; }
}

// 使用
const state = new FrozenState(fetch('/data').then(r => r.json()));
console.log(state.data.id); // ✅ 可读
state.data.id = 123;        // ❌ 无效(冻结生效)
</t></t></t>

注意冻结的局限性与替代思路

Object.freeze 是浅冻结:只冻结第一层属性,嵌套对象仍可变。若需深度不可变,需额外处理。

  • 简单场景下,约定数据结构扁平,或手动 freeze 嵌套对象
  • 复杂嵌套推荐用 immer 的 freeze 模式,或用 structuredClone + freeze 组合(现代环境)
  • 真正追求强不可变语义,可考虑 Proxy 拦截 + 冻结,但开销大,通常不必要

例如浅冻结不足时:

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

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4646

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1149

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4584

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

920

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1816

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3325

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4313

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2820

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

888

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.1万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.6万人学习