ResizeObserver 回调内需用 try-catch 捕获同步错误，因异步回调中的异常无法被外层捕获；对 entry.target 做存在性校验，安全访问 contentRect 后续计算仍需防护；异步操作需处理 Promise 拒绝；确保元素已挂载、避免 CSS 过渡干扰、及时清理 observer 防内存泄漏。
ResizeObserver 本身不会主动抛出 JavaScript 错误，但它的异步回调中若存在逻辑错误（如访问 null 属性、调用不存在的方法、JSON 解析失败等），会作为未捕获的异步异常被丢弃，导致静默失败。这类错误无法被外层 try-catch 捕获，必须在回调内部处理或配合全局机制兜底。
在回调函数内直接捕获同步错误
ResizeObserver 的回调是异步执行的，但回调体内的代码仍是同步运行。因此，所有可能出错的同步操作（如读取 DOM 属性、解析数据、调用工具函数）都应包裹在 try-catch 中：
- 对
entry.target做存在性校验，避免Cannot read property 'xxx' of null - 访问
entry.contentRect是安全的（规范保证其存在），但后续计算（如除法、字符串拼接）仍可能报错 - 若在回调中调用自定义方法（如
updateLayout(entry)），该方法内部也需自行处理异常，或在外层加try-catch
示例：
const ro = new ResizeObserver(entries => {for (const entry of entries) {
try {
const el = entry.target;
if (!el || !el.isConnected) return;
const w = Math.round(entry.contentRect.width);
el.style.setProperty('--width', `${w}px`);
} catch (err) {
console.error('ResizeObserver 回调执行失败:', err, 'target:', entry.target);
}
}
});
监听未处理的 Promise 拒绝（针对异步副作用）
如果在 ResizeObserver 回调里触发了 Promise 操作（例如：尺寸变化后自动请求接口、加载图片、调用 async 函数），这些 Promise 若被 reject 且未被 .catch() 或 try-catch 捕获，会触发 unhandledrejection 事件：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 在应用初始化时注册一次全局监听，用于捕获这类漏网异常
- 建议记录错误上下文（如关联的
entry.target.id），便于定位问题来源 - 可选择调用
event.preventDefault()阻止默认控制台警告，改用统一上报逻辑
示例：
window.addEventListener('unhandledrejection', event => {const { reason, promise } = event;
if (reason instanceof Error && reason.message.includes('ResizeObserver')) {
console.warn('ResizeObserver 相关异步操作失败:', reason);
// 上报监控系统
}
});
规避常见失效场景，减少“伪错误”
很多所谓“ResizeObserver 不工作”，实际是因规范限制导致无回调，并非 JS 错误。提前识别并规避，比事后捕获更有效：
- 确保元素已挂载到文档（
el.isConnected === true），display: none、visibility: hidden、未 append 的元素不会触发 - 不依赖 CSS 动画/transition 过程中的中间状态——只响应最终布局生效后的尺寸变更
- 父容器尺寸不变时，仅靠百分比撑开的子元素也不会触发（contentRect 未重算）
- 检查浏览器兼容性：IE 完全不支持；Safari ≤13.0、旧版 Android WebView 需 polyfill 或降级方案
主动清理与资源隔离
未及时清理观察者可能导致内存泄漏或回调执行在已销毁的组件上，引发 Cannot set property of null 类错误：
- 组件卸载、元素移除前务必调用
ro.unobserve(el)或ro.disconnect() - 在 React/Vue 等框架中，将 observer 实例绑定到组件实例或 ref，确保生命周期一致
- 避免在回调中直接修改已被移除的 DOM 节点，可先校验
el.parentNode !== null
