讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

深度解析script标签之nomodule属性

大墨姑娘_6498

大墨姑娘_6498

发布时间:2026-07-03 11:47:49

|

236人浏览过

|

来源于php中文网

原创

nomodule不是兼容开关,而是现代浏览器的跳过指令;必须与type="module"成对使用,单独写会导致新旧浏览器均白屏;nomodule脚本须为ES5兼容的IIFE/UMD格式并含polyfill,且Safari 10.1需运行时检测规避双执行。

深度解析script标签之nomodule属性

nomodule 不是兼容开关,而是现代浏览器的跳过指令

单独写 <script nomodule src="fallback.js"></script> 会导致现代和旧浏览器都可能白屏。Chrome、Firefox、Safari(61+/60+/11+)看到 nomodule 就直接跳过:不发请求、不解析、不执行;IE11 和 Android 4.4 WebView 根本不认识这个属性,但也不会“自动降级”——它会静默忽略整行标签,既不报错也不加载。结果是:新用户没 JS,老用户也没 JS。

真正起作用的是组合行为:type="module" 和 nomodule 必须成对出现,且语义互斥:

  • 支持 type="module" 的浏览器:执行第一行,跳过第二行
  • 不支持 type="module" 的浏览器:丢弃第一行,把第二行当普通 <script src></script> 同步加载执行

推荐写法(模块优先):

<script type="module" src="app.mjs"></script>
<script nomodule src="legacy-bundle.js"></script>

nomodule 脚本必须是真·ES5 兼容的 IIFE/UMD

nomodule 只控制“要不要加载”,不管“能不能运行”。哪怕脚本进了 IE11,以下任一情况都会立刻崩溃:

  • 语法错误:const、let、=>、${}、class → 直接 SyntaxError
  • API 缺失:fetch()、Promise、Array.from()、Object.assign() → ReferenceError 或静默失败
  • DOM 方法不可用:element.classList.add()(IE9–)、querySelector()(IE7–)、addEventListener()(IE8–)→ 报错或无响应

构建时必须显式指定目标环境,不能依赖默认 preset:

  • Babel 配置需含 targets: { ie: "11" }
  • 手动引入 core-js/stable,且 polyfill 必须在所有业务代码之前执行
  • 输出格式只能是 IIFE 或 UMD,严禁含 import/export,禁用 dynamic import()

Safari 10.1 的双执行陷阱必须 runtime 规避

Safari 10.1(macOS 10.12.4 / iOS 10.3)是个特例:它识别 type="module",却错误地也执行 nomodule 脚本。结果是 app.mjs 和 legacy-bundle.js 同时加载、同时执行——UI 初始化两次、事件重复绑定、API 请求翻倍。

最稳妥的缓解方式是加一层运行时检测,只让 Safari 10.1 这类“半吊子”浏览器走降级路径:

if (!('noModule' in document.createElement('script'))) {
  const s = document.createElement('script');
  s.src = 'legacy-bundle.js';
  document.head.appendChild(s);
}

注意:不能用 document.write(),它在 modern HTML 中已不安全;也不能把检测逻辑塞进 legacy-bundle.js 里——那已经晚了。

旧浏览器中 nomodule 脚本是同步阻塞的

在 IE11 等旧环境中,<script nomodule src="legacy-bundle.js"></script> 等效于普通 <script src></script>,没有 async 或 defer 行为。这意味着:

  • 它会同步阻塞 HTML 解析,页面渲染卡住直到脚本下载并执行完毕
  • async 属性在 IE11 中被忽略,写了也无效
  • 体积越大、执行越慢,首屏白屏时间越长

实操建议:

  • 把 legacy-bundle.js 压缩到最小,用 UglifyJS 或 SWC 配合 preset-env 做深度 tree-shaking
  • 关键初始化逻辑(如 DOM 就绪判断、基础 polyfill 注入)可内联进 HTML,避免额外请求
  • 不要指望 nomodule 脚本能“优雅异步”,它就是个同步 fallback,得按最差体验来优化

最容易被忽略的一点:加载成功 ≠ 能跑通。哪怕你确认 IE11 加载了脚本,只要里面有一行 const x = 1 或 fetch('/api'),它就立刻中断——nomodule 不做任何语法或 API 兼容性兜底。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7535

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4132

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3810

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

3819

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

5279

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3761

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3569

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

3068

2023.09.01

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn