当前位置:首页 > 文章列表 > 文章 > 前端 > JavaScript ResizeObserver 怎样避免观察回调循环

JavaScript ResizeObserver 怎样避免观察回调循环

来源:17golang原创 2026-11-19 19:56:48 0浏览 收藏
热门推荐
漫画APP
动画内容聚合,热门资源快捷查看
立即下载

如果控制台反复出现 ResizeObserver loop completed with undelivered notifications,先不要把 ResizeObserver 当成坏掉的 API。通常是回调里修改了被观察元素的尺寸,下一轮布局又触发了同一个回调。稳定做法有两类:不需要改变尺寸时,用“预期尺寸”挡住重复写入;确实要调整时,把写入放进 requestAnimationFrame,并保证每次只写入必要的变化。

本文只讨论尺寸回调、批处理和循环警告,不把窗口 resize 事件混在一起。

先看懂 ResizeObserver 循环警告

ResizeObserver 观察的是元素的尺寸,而不是整个视口。当回调读取当前尺寸后又直接写回 width、height 或会改变盒模型的样式时,写入可能触发布局重新计算。浏览器会处理一部分通知;如果还有更深层的观察对象没有在这一轮交付,就把剩余通知推迟到下一次绘制,并报告循环警告。

因此,警告说明“这一轮没有收敛”,不等于浏览器已经替你修好了循环。下面这种写法会持续把宽度加大,不能靠监听 window 的 error 事件来修复:

const panel = document.querySelector('.panel');

const observer = new ResizeObserver((entries) => {
  for (const entry of entries) {
    // 每次回调都改变被观察对象,下一轮仍然会产生新尺寸。
    entry.target.style.width = `${entry.contentRect.width + 10}px`;
  }
});

observer.observe(panel);

ResizeObserver 尺寸回调与布局反馈关系说明图
图1:说明图展示“回调写尺寸—布局变化—再次观测”的反馈关系,以及预期尺寸边界的作用。

用预期尺寸让回调变成幂等操作

如果组件的目标是把元素调整到某个确定尺寸,先把目标记录在 WeakMap 中。回调再次收到相同尺寸时直接返回,不再写样式。这里的关键不是简单加一个布尔锁,而是比较“当前观测值”和“上一次计划写入的值”,这样多元素观察也能各自收敛。

const expectedWidth = new WeakMap();

const observer = new ResizeObserver((entries) => {
  for (const entry of entries) {
    const currentWidth = entry.contentBoxSize?.[0]?.inlineSize
      ?? entry.contentRect.width;
    const targetWidth = Math.max(240, Math.round(currentWidth));

    // 已经写入同一个尺寸时不重复触发布局。
    if (expectedWidth.get(entry.target) === targetWidth) {
      continue;
    }

    expectedWidth.set(entry.target, targetWidth);
    entry.target.style.width = `${targetWidth}px`;
  }
});

observer.observe(document.querySelector('.panel'));

这个例子只把当前值归一化到不小于 240px;生产代码应把“目标尺寸”替换为真实业务规则。若目标值本身依赖字体、边框或子节点,又会随布局变化重新计算,就要继续缩小写入范围,避免回调负责过多布局职责。

确实需要调整时,隔离读与写

有些组件必须根据最新尺寸改变内部布局。这时可以在回调里只收集测量结果,把样式写入交给下一帧。要点是合并同一帧内的多次通知,并在写入前再次判断目标值,避免多个回调排队。

const pending = new Map();
let frameId = 0;

const observer = new ResizeObserver((entries) => {
  for (const entry of entries) {
    // 回调阶段只读尺寸,不在观察通知中直接改布局。
    const width = entry.contentBoxSize?.[0]?.inlineSize
      ?? entry.contentRect.width;
    pending.set(entry.target, Math.max(240, Math.floor(width)));
  }

  if (frameId !== 0) return;
  frameId = requestAnimationFrame(() => {
    frameId = 0;
    for (const [target, width] of pending) {
      pending.delete(target);
      // 只有实际值不同才写入,避免空写造成下一轮通知。
      if (target.clientWidth !== width) {
        target.style.width = `${width}px`;
      }
    }
  });
});

observer.observe(document.querySelector('.panel'));

ResizeObserver 观测、测量和下一帧写入边界说明图
图2:说明图把通知、尺寸读取、下一帧写入和实际值比较分成边界,帮助定位循环来源。

多目标观察和清理别遗漏

一个观察器可以接收多个 entries,不要只处理数组第一个元素。需要停止单个目标时调用 unobserve(target);组件整体卸载时调用 disconnect(),同时取消尚未执行的动画帧并清空待写 Map。

function dispose(target) {
  // 先停止回调来源,再清理尚未写入的状态。
  observer.unobserve(target);
  pending.delete(target);
  expectedWidth.delete(target);
}

function destroy() {
  // 组件卸载时释放所有观察目标和下一帧任务。
  observer.disconnect();
  if (frameId !== 0) cancelAnimationFrame(frameId);
  pending.clear();
  frameId = 0;
}

contentBoxSize 在现代浏览器中通常是数组式的盒尺寸数据,但示例仍保留 contentRect.width 回退读取。选择 content-box 还是 border-box,要和你的计算口径一致;否则“看起来没有变化”的判断也可能一直不成立。

排查时抓住三个问题

  • 回调是否直接修改了正在观察的元素,或修改了会改变它尺寸的子节点?如果是,先移除空写。
  • 目标值是否每次都会变化?给数值做取整、设置上下限,并记录上一次计划值。
  • 业务是否真的需要 JS 改尺寸?仅做响应式布局时优先考虑 CSS 容器查询;需要读取实际尺寸再交给脚本。

总结一下:无意循环用预期尺寸或实际值比较让写入幂等;有意调整用 requestAnimationFrame 隔离读写并合并通知;组件销毁时解除观察和取消待执行帧。这样处理后,循环警告的根因得到修复,而不是只把控制台错误隐藏掉。

常见问题

出现一次循环警告就一定是死循环吗?

不一定。浏览器可能只是把本轮未交付通知推迟到下一帧;但如果每帧都出现,通常说明回调写入仍在持续改变观察结果,应检查目标值和布局依赖。

能不能直接在 window error 中过滤这条消息?

不建议。过滤只能隐藏症状,不能阻止布局抖动或持续写入。只有在确认是浏览器或第三方组件无法立即修改时,才把它作为临时观测手段。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址
上一篇
JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址
JavaScript fetch 怎样区分网络失败和 HTTP 404
下一篇
JavaScript fetch 怎样区分网络失败和 HTTP 404
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1128次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1112次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1287次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1227次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1078次使用