如何利用 Proxy 拦截状态变更实现一套具备“撤销重做”功能的业务数据层

阿婷同学_3129

阿婷同学_3129

2026-05-09

903人浏览

原创

只代理 set 无法支持可靠撤销,因为会漏掉数组方法调用、嵌套对象未代理导致的深层修改遗漏、以及多个属性连续修改缺乏事务原子性,必须结合历史栈、变更描述和状态克隆机制。

如何利用 proxy 拦截状态变更实现一套具备“撤销重做”功能的业务数据层

直接用 Proxy 拦截 set 就能记录变更,但只拦 set 不行——撤销重做需要完整操作快照、可逆执行、状态回滚能力,必须配合历史栈 + 变更描述 + 状态克隆机制。

为什么只代理 set 无法支持可靠撤销

单纯在 set 陷阱里 push 一条“旧值→新值”记录,会漏掉三类关键信息:

  • 数组索引赋值(如 list[2] = 'x')或 push/splice 等方法调用,不会触发 set(除非你额外拦截 apply 或重写数组方法)
  • 嵌套对象深层修改(如 user.profile.name = 'Bob'),若 profile 未被递归代理,变更根本不会被捕获
  • 多个属性连续修改(如 a=1;b=2;c=3)会被拆成多条独立记录,但用户视角是一次“提交动作”,撤销时应原子回退

所以必须把“一次业务操作”显式标记为一个单元,不能依赖底层属性访问自动聚合成事务。

用 Proxy + 操作日志 + 快照实现可撤销数据层

核心是把每次用户触发的业务动作(比如“添加订单项”“更新收货地址”)封装为一个带 execute 和 undo 方法的对象,由 Proxy 在 set 中不直接执行,而是生成该操作并推入历史栈。

实操要点:

  • 所有对响应式数据的修改,必须走统一入口函数(如 commit(operation)),禁止直接赋值;operation 是形如 { type: 'UPDATE_FIELD', path: ['user', 'email'], value: 'a@b.com' } 的描述对象
  • Proxy 的 set 陷阱仅用于拦截调试/误操作,生产环境应禁用直接赋值,靠 commit 驱动
  • 历史栈用两个数组维护:undoStack 存已执行的 operation 对象,redoStack 存刚 undo 过的操作;每个 operation 必须自带 undo 实现(例如还原 path 对应的老值)
  • 避免深拷贝性能损耗:用 structuredClone(现代浏览器)或 immer 的 produce 做不可变更新,快照只存 diff 而非全量状态

示例片段(简化版):

Bailian Usage Proxy
Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景:1)部署用量统计代理;2)统计多人Token用量和调用次数;3)管理大模型API调用配额。

下载
const state = { count: 0, items: [] };
const history = { undoStack: [], redoStack: [] };

function commit(op) {
  const oldState = structuredClone(state);
  // 执行变更(此处用 immer 或手动路径更新)
  applyOperation(state, op);
  history.undoStack.push({ op, oldState });
  history.redoStack = [];
}

// Proxy 仅作防护
const proxied = new Proxy(state, {
  set(target, key, value) {
    console.warn('禁止直接赋值,请使用 commit()');
    return false;
  }
});

嵌套对象和数组的变更如何统一捕获

Proxy 默认不递归代理子对象,而撤销重做要求任何层级的修改都可追溯。解决方案不是无脑递归,而是按需代理 + 路径标记:

  • 在 get 陷阱中,当返回值是对象或数组时,检查它是否已被代理;若否,用同一套 handler 创建新 Proxy,并记录该值对应的原始路径(如 ['user', 'profile'])
  • 所有数组方法(push, pop, splice)需包装:通过 get 返回的代理数组,其原型方法要被重写,调用前先生成 ARRAY_PUSH 类型操作并 commit
  • 关键点:不要在 set 里处理数组索引赋值(arr[0] = x),因为这仍会触发 set,但语义上属于“替换元素”,应转为 ARRAY_SET 操作,含索引与旧值

这意味着你得为数组单独实现一层代理逻辑,handler 里区分 typeof value === 'object' 和 Array.isArray(value),并分别处理。

撤销时如何保证视图同步且不丢失未提交变更

撤销不是简单 Object.assign 回老状态——那会丢掉当前用户正在输入但尚未 commit 的临时内容(比如表单里打了半截的地址)。正确做法是:

  • 真实状态(state)始终只由 commit 更新;UI 层读取的是 proxy 包装后的响应式对象,它内部可缓存“草稿值”
  • 撤销时,从 undoStack 弹出操作,调用其 undo() 方法反向修改 state,然后触发一次强制刷新(如调用 triggerEffect)
  • 如果用户在撤销后又做了新操作,清空 redoStack 并将新操作推入 undoStack —— 这是标准撤销链行为,不能跳过
  • 注意:若某次 commit 修改了 5 个字段,但 UI 只渲染了其中 2 个,撤销后那 3 个字段的变更也必须生效,否则状态不一致

最易被忽略的一点:撤销重做功能本身不该成为性能瓶颈。每条操作日志必须轻量(只存路径、类型、必要值),而非整个 state 快照;diff 计算和状态恢复逻辑要可预测、可测试,不能依赖副作用顺序。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

proxy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.06.20

5426

5

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

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

2023.07.04

1329

3

js四舍五入
js四舍五入

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

2023.07.04

5364

6

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

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

2023.09.01

1020

4

JavaScript转义字符
JavaScript转义字符

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

2023.09.04

1956

5

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

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

2023.09.04

3765

4

如何启用JavaScript
如何启用JavaScript

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

2023.09.12

4953

6

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

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

2023.09.20

3240

5

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

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

2023.09.20

1048

7

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习