JS 模块化- 05 ES Module & 4 大规范总结
1 ES Module 规范
ES Module 是目前使用较多的模块化规范,在 Vue、React 中大量使用,大家应该非常熟悉。TypeScript 中的模块化与 ES 类似。
1.1 导出模块
导出模块有两种方式:按需导出 和 默认导出。
按需导出是使用 export 关键字,将需要导出的成员(变量、函数、对象等)依次导出:
export const xxx = ''
export const xxx = () => {}
一个模块中可以有多个按需导出,但只能有一个默认导出。假设默认导出 A 模块,当 B 模块直接导入模块 A 时,其导入的值就是模块 A 默认导出的值。
export default {}
1.2 导入模块
导入按需导出的模块:
import { xxx } from 'xxx'
上面语法中,花括号 {} 中的内容必须与导出的名称一致。
如果按需导出的成员较多,可以使用 as 一次性导入:
import * as xxx from 'xxx'
导入默认导出的模块:
import xxx from 'xxx'
也可以直接导入一个模块,并直接执行该模块的代码:
import 'xxxxx'
2 使用 Webpack 编译 ES Module
2.1 初始化项目
创建 modules 目录,里面存放两个模块 module1.js 和 module2.js。入口文件与 modules 目录同级,名为 index.js。文件和目录结构如下:
05_ESM/
|- modules/
|- module1.js
|- module2.js
|- index.js
|- index.html
2.2 实现两个模块
module1.js 使用按需导出变量 str1 和函数 fun1,默认导出 user 对象:
console.log('in module1')
export const str1 = 'hello module1'
export const fun1 = (msg) => {
return `module1:${msg}`
}
const user = {
name: 'zhangsan',
age: 30
}
export default user
module2.js 使用默认导出,导出一个对象,这个对象包括属性 str2 和方法 fun2:
console.log('in module2')
const str2 = 'hello module2'
const fun2 = (msg) => {
return `module2:${msg}`
}
export default {
str2,
fun2
}
2.3 实现入口文件
在入口文件 index.js 中导入两个模块。由于 module1.js 是按需导出,故导入时需要使用 {}; module2.js 是默认导出,故此处可以直接导入:
import { str1, fun1 } from './modules/module1'
import m2 from './modules/module2'
console.log(str1)
console.log(fun1('程序员优雅哥'))
console.log(m2.str2)
console.log(m2.fun2('youyacoder'))
2.4 入口 HTML
创建 index.html 文件,使用 script 标签导入 index.js :
<script src="./index.js"></script>
在浏览器中访问 index.html 文件,控制台会提示如下错误:
Uncaught SyntaxError: Cannot use import statement outside a module (at index.js:1:1)
这是由于浏览器不认识 ESM 语法。可以使用 babel 将 ES6 语法编译为 ES5 的语法,然后使用 browserify 进行打包;也可以使用 webpack 打包。此处我使用 webpack 5。
2.5 使用 Webpack 打包
使用 npm 或 yarn 初始化项目:
yarn init -y
安装 webpack、webpack-cli 为开发依赖:
yarn add webpack webpack-cli -D
使用 webpack 打包:
npx webpack ./index.js -o ./dist/ --mode development
上面的打包命令直接在命令中配置参数,省略了额外的配置的文件。该命令指定了打包的入口文件为:index.js;输出的目录为 dist 目录,打包模式为 development。关于 webpack 5 的使用,有兴趣的可以看优雅哥的 webpack 5 系列文章。
执行完打包命令后,会生成 dist 目录,并且在该目录中有个 main.js 文件。
在 index.html 中删除之前引入的 index.js,替换为 dist/main.js:
<script src="./dist/main.js"></script>
重新在浏览器中访问 index.html, 控制台输出如下:
3 ES Module 总结
导出模块:
- 默认导出:export default xxx
- 按需导出 export const xxx
导入模块:
-
默认导入: import xxx from 'xxx'
-
按需导入 import { xxx } from 'xxx'
4 JS 模块化 4 大规范总结
前面优雅哥依次写了模块化的发展史,模块化的规范(可进主页查看每个规范详细版本),现进行一个大汇总方便大家查阅和总结:
05 - ESM 规范
模块化相关 demo 源码可以 github 搜索关键词 js-module-demo 或联系 程序员优雅哥 获取。
源码目录如下:
js-module-demo/
|- 01_Histry/ 模块化发展史
|- 02_CommonJS/ CommonJS 规范
|- 03_AMD/ ADM 规范
|- 04_CMD/ CMD 规范
|- 05_ESM/ ESM 规范
各个模块化规范有相似之处,也有差异,模块定义与模块加载的语法如下:
4.1 Common JS 规范
定义模块的语法:
// 暴露函数
module.exports = function () {}
// 暴露对象
module.exports = {
xxx: () => {}
}
exports.xxx = {}
exports.xxx = function() {}
加载模块的语法:
const xxx = require('xxxx')
4.2 AMD 规范
定义模块的语法:
define(id?, dependencies?, factory)
加载模块的语法:
require([module], callback)
4.3 CMD 规范
定义模块的语法:
// 定义模块
define(function(require, exports, module) {
// 使用 exports 导出模块
exports.xxx = xxx
//也可以使用 return 导出模块
// return xxx
})
加载模块的语法:
// 同步加载模块
const m1 = require('../xxx')
// 异步加载模块
require.async('../xxx', function (m2) {
})
4.4 ESM 规范
导出模块:
// 按需导出
export const xxx = ''
export const xxx = () => {}
// 默认导出
export default xxx
导入模块:
import { xxx, yyy } from 'xxx'
import * as xxx from 'xxx'
import xxx from 'xxx'
import 'xxx'
感谢你阅读本文,如果本文给了你一点点帮助或者启发,还请三连支持一下,点赞、关注、收藏,作者会持续与大家分享更多干货