nomodule必须与type="module"成对使用才有效;单独写会导致现代浏览器跳过、旧浏览器(如ie11)静默忽略,全白屏;正确结构是与并存,且后者须为es5兼容iife/umd格式并含polyfill。

nomodule 必须和 type="module" 成对出现才能生效
单独写 <script nomodule src="legacy.js"></script> 是无效的:现代浏览器直接跳过、不发请求;IE11 等旧浏览器则静默忽略整行标签,脚本根本不会执行——结果是新旧用户全白屏。
真正起作用的结构只有这一种组合:
<script type="module" src="app.mjs"></script><script nomodule src="legacy-bundle.js"></script>
- Chrome 61+、Firefox 60+、Safari 11+:加载并执行
app.mjs,完全跳过legacy-bundle.js(Network 面板里搜不到它) - IE11、Android 4.4 WebView、Edge 15 及更早:不认识
type="module",跳过第一行;也不认识nomodule,但会照常加载并执行第二行 - 顺序不强制,但推荐模块优先,符合逻辑直觉,也方便构建工具(如 Vite/Webpack)自动生成
legacy-bundle.js 必须是真·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–)→ 报错或无响应
实操要点:
- Babel 配置必须显式设
targets: { ie: "11" },不能依赖默认 preset -
core-js/stable或whatwg-fetch等 polyfill 要手动引入,且必须在所有业务代码之前执行 - 输出格式只能是
IIFE或UMD,严禁含import/export,禁用dynamic import()
旧浏览器中 nomodule 脚本的执行时机很危险
现代浏览器中 type="module" 默认是 defer 行为(按文档顺序执行,不阻塞 HTML 解析);但旧浏览器把 <script nomodule></script> 当作普通同步脚本处理——若没加 defer,它会在 DOM 尚未就绪时就运行。
典型问题:document.getElementById("app") 返回 null,初始化失败。
建议写法:
<script type="module" src="app.mjs"></script><script nomodule defer src="legacy-bundle.js"></script>
- 显式加
defer可让旧浏览器行为接近现代路径,避免 DOM 访问时机错乱 - 不要依赖 UA 判断再异步加载 polyfill——IE11 解析慢,多一层网络请求极易超时或中断
- 关键初始化逻辑可考虑内联到 HTML 中(压缩后),减少首屏 JS 依赖
Safari 10.1 是唯一双执行例外
Safari 10.1(macOS Sierra / iOS 10.3)存在已知 bug:它既支持 type="module",又错误地执行了 nomodule 脚本,导致两份代码都被加载运行。
解决办法只能靠运行时检测,不能靠 HTML 属性:
if (!('noModule' in HTMLScriptElement.prototype)) {
// Safari 10.1 进入这里,需主动移除或跳过 legacy-bundle.js 的执行逻辑
}
- 这个检测必须放在
legacy-bundle.js开头,且不能依赖任何外部 polyfill - Webpack/Vite 构建时无法自动规避,必须手动注入该检查逻辑
- 其他现代浏览器(包括 Safari 11+)均无此问题,无需额外处理
nomodule 标签严格对应**。差一个 Babel target 版本,或漏掉一行 import 'core-js/stable',IE11 就会在控制台静默报错,而你只看到页面空白。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











