动态 import() 是浏览器原生支持的唯一可靠动态模块加载方式,返回 Promise,支持表达式路径、CORS 远程加载及错误捕获,但要求远程脚本为 ES 模块格式且响应头正确。

动态 import() 是唯一可靠方式
浏览器原生支持的动态模块加载,只能用 import() 函数,不是语法糖,是返回 Promise 的函数调用。它能加载远程 .js 文件(需符合 CORS),且支持表达式拼接路径——这是 require() 或静态 import 做不到的。
- 必须传入字符串字面量或运行时可求值的字符串(如
import(`./mods/${name}.js`)) - 不能传变量直接拼接(
import(myUrl)会报Dynamic import() expects a string literal) - 加载失败会 reject,必须用
.catch()或try/catch捕获,否则抛未处理 promise rejection
远程模块必须是 ES 模块格式
用 import() 加载远程脚本时,响应头需包含 Content-Type: application/javascript,且脚本本身必须是有效的 ES 模块(含 export 或 export default)。CommonJS(module.exports)或 IIFE 格式会静默失败或报 TypeError: Cannot instantiate module。
- 服务端要配好 CORS:至少允许
Access-Control-Allow-Origin: *(开发)或具体域名(生产) - 如果模块里用了
import.meta.url或相对路径import,注意浏览器解析 base URL 是模块自身 URL,不是页面 URL - 不支持
import('./utils.js').then(m => m.default())这种写法——m是命名空间对象,得用m.default?.()或解构{ default }
避免重复加载和缓存陷阱
import() 默认受浏览器 HTTP 缓存控制,但模块脚本一旦被加载并实例化,就会被 JavaScript 引擎缓存(同一 URL 不会重复执行),这点和 fetch() 不同。但如果你改了模块内容却没更新 URL,用户可能拿到旧版本。
- 开发时可在 URL 后加时间戳或哈希(
import(`./mod.js?t=${Date.now()}`)),但上线必须去掉,否则破坏缓存 - 想强制刷新已加载模块?做不到。ESM 没有
import.unload(),只能靠重新设计模块粒度(比如把逻辑包进函数里,每次调用新实例) - 多个地方同时
import('./a.js'),浏览器只发起一次请求,后续 resolve 同一个 Promise —— 这是规范行为,不是 bug
常见错误:跨域、MIME、语法错误全在 console 报错
动态加载失败时,错误信息很具体,但分散在不同阶段,得看清楚是哪一步崩了:
淘宝互刷平台刷信誉源码主要特性:1、系统采用国内著名CMS内核做为基础模块化开发,继承CMS原有强大功能之外,同时拓展任务模块、快递单模块、会员模块、信用评价模块等多个相关模块,支持生成HTML静态和动态ASP,有效的提高了系统的性能,不仅减轻服务器的负载提高搜索收录率,增加网站收录。2、系统主要由淘宝任务、天猫任务、京东任务、阿里任务、拼多多任务、收藏任务、流量任务、快递单生成与查询系统、信用评
立即学习“Java免费学习笔记(深入)”;
-
Failed to fetch dynamically imported module→ 网络失败或 404,检查 URL 和 CORS 响应头 -
Invalid or unexpected token→ 返回内容不是 JS(比如 HTML 错误页),或服务端没设对Content-Type -
Cannot use import statement outside a module→ 脚本被当成普通 script 执行(比如通过script.src注入),但你实际用的是import(),说明模块本身语法有问题(如用了 top-levelawait但浏览器不支持) -
Module not found这类提示其实是打包工具(如 Webpack/Vite)的警告,原生import()不会报这个,而是上面那些底层错误
const loadPlugin = async (url) => {
try {
const mod = await import(url);
return mod.default ? mod.default : mod;
} catch (err) {
console.error('Dynamic import failed:', err.message);
throw err;
}
};
// 用法
loadPlugin('https://cdn.example.com/widgets/chart.js')
.then(ChartWidget => ChartWidget.render(document.body));
真正麻烦的不是怎么写这三行,而是确保那个远程 chart.js 文件从响应头到导出语法都严格合规——漏掉任意一环,控制台就只给你一个模糊的 “failed to fetch”。










