onerror内联写法是唯一跨浏览器可靠的方案,必须写成onerror="this.src='fallback.png'; this.onerror=null"防死循环,且仅响应网络请求失败,对空src、CORS阻塞、200占位图等场景不触发。

onerror内联写法是唯一跨浏览器可靠的方案
动态绑定 img.onerror 或用 addEventListener('error', ...) 在旧版 Safari、IE11 和部分 Android WebView 中根本不会触发——不是延迟,是彻底静默。只有直接写在 HTML 标签里的 onerror 属性,才能确保 Chrome、Firefox、Safari(iOS 10+)、Edge(Chromium 版)全部响应。服务端渲染(SSR)页面首屏加载失败时 JS 还没执行,此时只有内联 onerror 能兜底。
防死循环必须写成 this.onerror=null,且要加路径判别
只写 onerror="this.src='fallback.png'" 是危险操作:一旦 fallback 图也 404,浏览器会反复请求、反复触发、反复重试,内存飙升,标签页卡死甚至崩溃。真实项目中已多次复现。
-
onerror="this.src='fallback.png'; this.onerror=null"是底线要求,this.onerror=null必须紧接在赋值后 - 更稳妥的做法是加路径检查:
onerror="if (!this.src.includes('fallback')) { this.src='fallback.png'; this.onerror=null; }" - 推荐用 base64 内联 SVG 占位图,彻底规避路径风险:
onerror="this.src='data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzAiIGhlaWdodD0iMzAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgZmlsbD0iI2ZmZiIvPjwvc3ZnPg=='; this.onerror=null"
哪些情况 onerror 根本不触发,别白费劲
它只响应“发出了请求但返回了网络错误”(404/403/500/连接中断),对以下场景完全沉默:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
src为空字符串、undefined或纯空格 —— 浏览器压根不发请求 - CORS 阻塞(比如跨域图片没加
crossorigin)—— 控制台报错,但onerror不进 - 服务器返回 200 状态码的兜底页(如 CDN 的“图片不存在”占位图)—— 浏览器认为“成功加载”
- 图片文件头正常但数据损坏(JPEG 块错乱)——
naturalWidth === 0可检测,但需额外 JS 判断
动态插入的 img 元素 onerror 绑定时机很关键
如果先 appendChild() 再赋值 onerror,第一次加载失败已经发生,事件监听器永远收不到。必须在插入 DOM 前完成绑定:
立即学习“前端免费学习笔记(深入)”;
const img = document.createElement('img');
img.src = 'dynamic.jpg';
img.onerror = function() {
this.src = 'fallback.png';
this.onerror = null;
};
container.appendChild(img);
注意:这里用的是赋值方式而非 addEventListener,因为后者在 Safari 旧版本中仍不可靠;若用内联写法,则需拼字符串或设置 outerHTML,但要注意 XSS 风险。


















