nomodule不是兼容开关,而是现代浏览器的“跳过指令”;单独使用会导致新旧浏览器均白屏,因现代浏览器跳过该脚本,旧浏览器(如IE11)则静默忽略整行标签而不执行,必须与type="module"成对使用且legacy脚本需ES5兼容并含polyfill。

nomodule 不是兼容开关,单独用它会让新旧浏览器都白屏。 它只在支持 type="module" 的浏览器中生效,告诉它们“跳过这个脚本”;不支持模块的旧浏览器(如 IE11、Android 4.4 WebView)根本识别不了 nomodule,但也不会报错——而是静默忽略整行标签,导致脚本压根没加载。
为什么 <script nomodule src="legacy.js"></script> 在 IE11 里不执行
IE11 不认识 nomodule 属性,但它也**不执行该标签里的脚本**。这不是 bug,而是规范行为:浏览器遇到无法识别的 type 或不理解的布尔属性时,会跳过整个 <script> 元素解析。结果就是——现代浏览器跳过,旧浏览器也跳过,页面 JS 彻底断掉。
- Chrome DevTools Network 面板搜
legacy.js,它不该出现(说明被现代浏览器跳过) - IE11 控制台执行
typeof module返回"undefined",但legacy.js里的代码也没运行,基本可判定是单写nomodule导致的丢弃 - 真正起作用的永远是组合:
type="module"和nomodule必须成对出现,且各自带src
nomodule 脚本必须是真·ES5 + 手动 polyfill
nomodule 只管“要不要加载”,不管“能不能跑”。哪怕脚本进了 IE11,以下任一情况都会立刻崩溃:
- 语法层面:含
const、let、=>、${}、class→ 直接SyntaxError - API 层面:调用
fetch()、Promise、Array.from()、Object.assign()→ReferenceError或静默失败 - DOM 层面:用
element.classList.add()(IE9–)、querySelector()(IE7–)、addEventListener()(IE8–)→ 报错或无响应
构建时必须显式设 targets: { ie: "11" },不能依赖 Babel 默认 preset;core-js/stable 需手动引入,且 polyfill 必须在所有业务代码之前执行;输出格式只能是 IIFE 或 UMD,严禁含 import/export,禁用 dynamic import()。
立即学习“前端免费学习笔记(深入)”;
Safari 10.1 的双执行陷阱
Safari 10.1(macOS 10.12.4 / iOS 10.3)是个特例:它识别 type="module",却错误地也执行 nomodule 脚本,导致 UI 初始化两次、事件重复绑定、数据请求翻倍。
最稳妥的缓解方式是加一层运行时检测,只在“半吊子”浏览器中注入 fallback:
if (!('noModule' in HTMLScriptElement.prototype) && 'onbeforeload' in HTMLScriptElement.prototype) {
const script = document.createElement('script');
script.src = 'legacy-bundle.js';
document.head.appendChild(script);
}
这个判断能精准捕获 Safari 10.1,避免其他浏览器误伤。别指望 nomodule 自动兜底——它本身不处理运行时兼容,只做加载路由。
最容易被忽略的一点:旧脚本体积再小,只要用了现代语法或 API,就等于没写;而现代脚本里哪怕只漏了一个 async 或 integrity,在严格 CSP 环境下也可能被拦截。兼容不是加个属性就完事,是构建、加载、执行三阶段全链路对齐。



















