- Published on
一个入门级别的前端打包工具
- Authors
- Name
- Pursue
写在前面
长期以来,前端的模块化管理都不很成熟(
webpack
出现之前),为此,早期(ES5 时代)为了实现依赖管理,甚至会利用window
等全局对象进行模块注册。而如今有了webpack
,rollup
等优秀的打包工具,让前端开发起来事半功倍,因此笔者觉得很有必要去学习下这种划时代工具的实现思路。因此,本篇将讲述如何一步步实现一个初级的前端打包工具,仅供学习和分享,希望读完后可以让大家对打包工具不只是停留在会用(光看文档)的基础上,而是能够有更多的思考(比如如何优化和按需定制)。
如果你准备好了,请先倒一杯咖啡,因为此文略长(且最好亲自运行)
源码请戳这里
所谓打包工具,无非是将js
, css
以及其他资源文件进行合并(本篇只讨论js
,其他类型的文件你读完后必然有自己的思路)。
以webpack
的 start-kit 为例子:
module.exports = {
entry: path.resolve(__dirname, 'index.js'),
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'main.js'
}
};
配置很简单,它只需要entry
和output
(甚至可以有默认的)即可。
那么它是怎么做的呢?我们来分析一个vanilla的demo
。
main.js
import app from './application.js';
import config from './config/index.js';
const { appName, version } = config;
app.start(appName, version);
main.js
有以下特点:
1.有依赖
./application.js
和./config/index.js
,2.使用了 ESM 引入依赖
import ...
3.依赖也有自己的导出
./application.js
源码里有export default
(这里避免冗长,没有展示); 依赖的依赖也许还会有export const xxx
;4.main 文件自身并没有导出
基于此,可以提出以下问题:
1.怎么处理
ESM
导入/导出的语法,貌似Node.js
和Browser
都不认识import
关键字呀?2.假设 1 已经解决,怎么将依赖处理成一个模块,且支持自身导出和外部引用?
3.如何分析依赖,以及依赖的依赖,以及。。。。
1 模块导入导出
我们先以ESM
作为讨论。
1.1 ESM in browser
你也许没有关注,目前ESM
在许多浏览器里是可以直接使用的:
index.html
<script type="module">
import showVersion from './index.js';
showVersion();
</script>
index.js
import { version } from './config.js';
export default () => {
console.log(`====== app version: ${version} ======`);
}
是不是很方便?
** 但其中问题也不少:**
- 1.文件路径
这里我所有的文件都必须写后缀(否则报错),且路径必须是以服务器的host
为相对路径,这就极大的限制了模块的路径解析规则(alias,node_modules 等)。
- 2.http 请求
如果你尝试上面的代码,会发现这种方式是直接去请求的文件,且请求顺序是有顺的。
这首先会需要大量http
请求,且隐式的需要让callback
也有序,不然可能会出现f1
在f2
之前请求的,但却晚回来,f2
却依赖了f1
里的方法,那么就会跪。
- 3.不支持 CJS
如果我写了Node.js
环境的代码,是没办法用这种方式加载的,更别提其他模块机制了。
1.2 ESM in Node.js
默认情况下是无法在Node.js
环境下使用ESM
的,但是自从13.9
版本以上,可以开启 flag --experimental-modules
,并且在package.json
里:
{
"type": "module"
}
1.3 从 ESM 到 CJS
不难看出,单就ESM
在浏览器和Node.js
的兼容就有诸多问题。为了消除差异,目前主流的做法并不是在浏览器里直接使用ESM
,取而代之的是将ESM
先转化为通用型的CJS
。比如上面的main.js
,利用Babel
转换后如下:
"use strict";
//1
var _application = _interopRequireDefault(require("./application.js"));
//2
var _index = _interopRequireDefault(require("./config/index.js"));
//3
function _interopRequireDefault(obj) {
return obj && obj.__esModule ? obj : { default: obj };
}
//4
var appName = _index.default.appName,
version = _index.default.version;
//5
_application.default.start(appName, version);
首先 1,2 已经把import
改为了require
。
其次,3 处对require
的实现做了一次签名包装:若module
为ESM
则具有内部属性_esModule
,此时默认导出的模块就是自身;否则,需要封装为{ default: obj }
。
最后 4,5 处,由于./application.js
和./config/index.js
均为默认导出,所以使用时需要取出default
属性,完全是按照 3 的标准来解析的。
看到这里,似乎问题已经解决了一大半了(代码已经归一化了),但还有一个问题没有解决:
** 这个 main.js 目前只有模块导入,如果也有导出的话,导出/导入该怎么实现?**
这里必须澄清,require 并不一定就在说 Node.js 的 require, Node.js 只是 commonJS 标准的一种实现。
2 模块导出的通用解决方案
和上面一样,我们用Babel
测试以下ESM
的导出转换:
ESM:
export default A;
export const name = '';
After Babel:
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.name = exports.default = void 0;
var _default = A;
exports.default = _default;
var name = '';
exports.name = name;
很简单,默认导出export default
转化为exports.default
;变量导出export const xxx
转化为exports.xxx
。
那万一需要打包的代码使用了CJS
呢?
CJS:
module.exports = A;
module.exports = {
name: ''
}
After Babel:
module.exports = A;
module.exports = {
name: ''
};
什么?居然一样。没错,这就是目前的标准:因为浏览器端和Node.js
端对ESM
的支持都还不成熟,所以所谓的转译就是ESM
转CJS
的过程。
这样一来,我们就只用处理commonJS1
和commonJS2
的情况就好了,即代码里模块操作只有require
,exports.default
,exports.xxx
, module.exports
,所以任意文件的代码都可以按照如下来封装:
index.js
function(require, module, exports) {
// source code
}
有require
是因为有可能还需要引用其他模块,这个我下面会讲到。
exports
等价于module.exports
,因此本质上是利用module
对象去注入原始代码,最终取出导出的模块。
到这里,我们还有一个
通用型的导入
方案没有分析到,这个阶段还不好解释,稍后会说明。
3 导入路径分析
当我们导入一个模块时,一般有两类写法:
//1
import _ from 'lodash';
//2
import util from './util';
其中 1 的寻找规则默认会去项目根目录下的node_modules
里寻找;
而 2 的寻找规则就稍微复杂一点:
当./util
没有package.json
文件时会去尝试寻找./util
;否则会查看package.json
里的main
属性作为入口。
以上规则的前提没有用任何的打包工具,比如用webpack
打包时路径的分析会比这个要复杂的多,还牵扯到main
,module
,browser
等的优先级。所以基于此,我们这里把规则定的简单点:
1.默认外部依赖的路径为
${projectRoot}/node_modules
2.
./util
等价于./util.js
或./util/index.js
3.任何以字符开头的路径均代表外部依赖(
util
等价于${projectRoot}/node_modules/util/index.js
)
于是首先我们需要把相对路径转化为绝对路径:
function buildPath(relativePath, dirname, config) {
const { entry } = config;
const NODE_MOUDLES_PATH = `${path.dirname(entry)}/node_modules`;
if (relativePath === entry) {
return relativePath;
}
let absPath = relativePath;
if (/^\./.test(relativePath)) {
absPath = path.join(dirname, relativePath);
} else {
absPath = path.join(NODE_MOUDLES_PATH, relativePath);
}
return revisePath(absPath);
}
buildPath
函数会根据当前文件所在的相对路径和父节点来尝试建立文件的绝对路径,因为后期我们需要去读这个文件。
function revisePath(absPath) {
const ext = path.extname(absPath);
if (ext) {
if (EXTENSIONS.indexOf(ext) === -1) {
throw new Error(`Only support bundler for (${EXTENSIONS}) file, current ext is ${ext}`)
}
if (fs.existsSync(absPath)) {
return absPath;
}
}
if (ext !== '.js') {
if (fs.existsSync(`${absPath}.js`)) {
return `${absPath}.js`;
}
if (fs.existsSync(`${absPath}/index.js`)) {
return `${absPath}/index.js`;
}
throw new Error(`Can not revise the path ${absPath}`)
}
//here relative path is absolute path
return absPath;
}
revisePath
函数仅仅是修复文件后缀,因为./util
可以代表./util.js
或./util/index.js
。
有了上面的概念,我们就可以进入我们的主题了。
4 Babel
上面分析了这么多关于模块导入导出的思路,当下摆在我们面前的第一步就是:** 如何在语法上识别一个文件里有依赖,以及依赖的路径是什么呢?**
这里不得不提一下Babel
转译源代码的步骤。
4.1 parse
parse
阶段会将源代码解析为抽象语法树(AST
),AST
通过词法分析生成对应类型的节点,详细的描述了每一行代码的具体特征
,例如:
index.js
//1
import app from './application.js';
//2
import config from './config/index.js';
//3
const { appName, version } = config;
//4
app.start(appName, version);
After parse:
可以看到 1,2 为导入声明,3 为变量声明,4 为表达式。
以 1 为例,1 为ImportDeclaration
, 表明是ESM
的import
(require
语法不会是这种类型的Node
),且source
里的value
为依赖模块的相对路径。但是这个树可能会很深,导致我们获取(也许也需要修改)具体信息的操作会很复杂(a?.b?.c?.e?....
),为此我们可以进入Babel
转译的第二个阶段。
4.2 traverse
traverse
可以方便的操作AST
,比如我们可以这样遍历ImportDeclaration
:
traverse(ast, {
ImportDeclaration({
node
}) {
const relativePath = node.source.value;
//record the dependency
}
});
而对于CJS
的require
,在AST
中存在于CallExpression
的 Node 上(笔者下面的寻找方式肯定不是最佳的):
traverse(ast, {
CallExpression({
node
}) {
const {
callee: {
name
},
arguments
} = node;
if (name === 'require') {
const relativePath = arguments[0].value;
//record the dependency
}
}
});
在traverse
的阶段我们还可以自定义一些语法,比如对于异步导入的模块来说,一般我们使用异步import...then
:
import('./util').then(...)
我们可以定义自己喜欢的语法糖:
dynamicImport('./api').then(
module => console.log('======successfully load dynamic moudle=====');
);
在然后像上面一样遍历该语法存在的节点:
traverse(ast, {
CallExpression({
node
}) {
const {
callee: {
name
},
arguments
} = node;
if (name === 'dynamicImport') {
const revisedPath = buildPath(relativePath, path.dirname(filename), config);
//record the dependency
}
}
});
类似的,我们甚至可以模拟ES7
的Decorator
(@xxx),traverse
的具体API
在这里就不赘述了。
4.3 transform
生成了AST
,遍历/修改了AST
,最终Babel
的目标是还是js
代码。transform
可以将我们修改后的AST
再转回代码。
在这一过程中,一般只需要配置一下Babel
的presets
即可,比如我们常用的preset-env
就是 ES6->ES5,如果什么都不设置,那Babel
就什么也不干。
presets
的角色比较上层,或者说它是一种宏观的规则,对于一些非常具体的代码转换逻辑,就需要plugin
了。比如我们上面使用了dynamicImport
语法,在traverse
阶段我们也遍历到了该信息,但是这毕竟不是js
语法,我们是需要写一个小插件来进行语法转换(Babel
插件的写法这里就不赘述了)的:
动态导入语法的插件plugin/dynamicImport.js
:
module.exports = {
visitor: {
Identifier(path) {
if (path.node.name === 'dynamicImport') {
path.node.name = 'require';
}
}
}
};
该插件会把dynamicImport
替换为require
。
然后利用插件以及配置好的preset
,最终输出转译后的代码。
const { code } = babel.transformFromAstSync(
ast, null, {
plugins: [
dynamicImportPlugin
],
presets,
}
);
至此,Babel
转译js
的流程就介绍完了。
package
参考:
parse
阶段:const parser = require('@babel/parser');
traverse
阶段:const traverse = require('@babel/traverse').default;
transform
阶段:const babel = require('@babel/core');
5 实现
5.1 生成资源文件(Asset)
我们建立一个很简单vanilla项目,结构如下:
vanilla
│ main.js
│ constant.js
│ application.js
└───utils
│ └───log.js
└───config
└───index.js
main.js
import app from './application.js';
import config from './config/index.js';
const { appName, version } = config;
app.start(appName, version);
我们先开始分析依赖。
对于main.js
,它是这个项目的入口,这个必须由调用者提供,我们期望从main.js
分析出如下信息:
{
id: String,
code: String,
filename: String,
dependencies: String[]
}
我们可以把这个结构称作一个资源文件(Asset
),它由模块标识符(id
),代码(code
),文件名(filename
)和依赖(dependencies
)组成,它的依赖示例如下:
dependencies = ['./application.js', './config/index.js']
同理,dependencies
里的元素本身也应该代表一个Asset
。
生成一个Asset
的逻辑如下:
- 1.生成资源 id
简单点,我们这里使用自增 id(第一个资源 id 为 0)。
- 2.读取源代码
直接同步读取文件(暂时不考虑内存和效率)。
- 3.生成 AST
- 4.遍历 AST,收集依赖
收集依赖只是将依赖添加到队列中(遍历 AST 不再赘述):
const dependencies = [];
traverse(ast, {
ImportDeclaration({
node
}) {
const relativePath = node.source.value;
dependencies.push(relativePath);
}
});
注意,依赖资源的路径是相对路径,后期使用时还需要修正, 参考上面的修正函数。
- 5.转换为源代码
最终代码大致如下:
function createAsset(filename) {
id++;
const file = fs.readFileSync(filename, 'utf8');
const dependencies = [];
const ast = parser.parse(file, {
sourceType: 'module'
});
traverse(ast, {
ImportDeclaration({
node
}) {
const relativePath = node.source.value;
dependencies.push(relativePath);
},
CallExpression({
node
}) {
const {
callee: {
name
},
arguments
} = node;
if (name === 'require') {
const relativePath = arguments[0].value;
if (/^\./.test(relativePath)) {
dependencies.push(relativePath);
}
}
}
});
const {
code
} = babel.transformFromAstSync(
ast,
null, {
presets,
}
);
return {
id,
filename,
dependencies,
code
}
};
5.2 生成资源树(Asset[])
再来回顾一下我们的项目结构,这是一个典型的以入口文件(main.js
)为根资源节点的树,我们采用DFS
进行遍历:
function createAssets(filename) {
const stack = [], assets = {};
const push = stack.push;
stack.push = function(asset) {
push.call(stack, asset);
assets[asset.filename] = asset;
}
stack.push(createAsset(filename));
//DFS
while(stack.length > 0) {
const asset = stack.pop();
asset.mapping = {};//1
asset.dependencies.forEach(relativePath => {
const revisedPath = buildPath(relativePath, path.dirname(asset.filename), config);
console.log(`Start extracting: ${revisedPath}`);
const depAsset = createAsset(revisedPath);
asset.mapping[relativePath] = depAsset.id;
stack.push(depAsset);
});
}
return assets;
};
上面的实现很简单,但有一点需要特别解释下,就是在 1 处我们给 asset 附加了一个mapping
属性。
mapping
记录的是当前资源下一层(第一层孩子节点)的依赖关系,它的key
为依赖资源的相对路径,value
为模块id
。这样就可以利用路径去反查id
。比如main.js
的依赖里必然有./application.js
,当我们建立完main.js
这个资源后,mapping
里大致有{"./application.js": 1}
这样的信息。这非常有用,当后面我们需要把main.js
这个资源进行打包时可以利用mapping
取出它所有依赖的模块。
5.3 整合所有资源
- 1.实现通用导出
有了asset
, assets
我们已经完成了一大半工作了(深吸一口气),为了让assets
聚合在一起,我们需要把资源‘拼’
在一起,毕竟最后输出的是一个文件。
拼接资源:
const modules = Object.values(assets)
.reduce((result, asset) => {
const {
id,
code,
mapping,
filename: revisedPath
} = asset;
return result += `
${id} : [
function(require, module, exports) {
${code}
},
${JSON.stringify(mapping)}
],
`
}, '');
对于main.js
,我们会整合为大致如下的结构:
0: [
function (require, module, exports) {
// main.js here
"use strict";
var _application = _interopRequireDefault(require("./application.js"));
var _index = _interopRequireDefault(require("./config/index.js"));
function _interopRequireDefault(obj) {
return obj && obj.__esModule ? obj : { default: obj };
}
var appName = _index["default"].appName,
version = _index["default"].version;
_application["default"].start(appName, version);
},
{ "./application.js": 1, "./config/index.js": 2 },
],
1: [
function (require, module, exports) {
// code resource here
},
{ "./utils/log.js": 4 },
],
2: [
function (require, module, exports) {
// code resource here
},
{ "../constant.js": 3 },
],
3: [
function (require, module, exports) {
// code resource here
},
{},
],
4: [
function (require, module, exports) {
// code resource here
},
{},
],
})
还记得上面提到的模块导出的通用解决方案吗?。
我们为所有的源代码封装了一个factory
:
function (require, module, exports) {
// code resource here
}
这里笔者特意没有换别名,还是用了大家熟悉的变量名(require
,module
,exports
),如果你愿意,完全可以换成类似webpack
的签名__pack_require__
,__pack_module__
, __pack__exports__
。
以main.js
为例(require
的实现我们稍后介绍),我们注入了module
和exports
对象,只要main.js
的factory
已执行,我们就可以拿到main.js
的代码。当然了,尽管有一些文件并没有任何的导出操作,但factory
也需要执行(毕竟要执行源代码),自然module
和exports
会显示没有使用。
- 2.实现通用导入
终于到了这一步了,笔者并不是特意要埋这个伏笔,只是如果你读到这里在来看导入的解决方案可能更加清晰。
我们暂时把上一步拼接好的资源叫做modules
,每一个module
有自己的factory
和mapping
。modules
算得上是初步的资源整合结果,我们还差一个require
没有实现。继续回顾上面main.js
的factory
,当执行factory
时,会遇到:
var _application = _interopRequireDefault(require("./application.js"));
其实到了这一步,./application.js
这个资源早已经被建好了(特殊情况除外,如代码分离),只要我们有一个全局的scope
(这就是moudles
呀)查询即可。
比如./application.js
对应的模块id
为1
,而1
号模块也有自己的factory
,一旦执行,不就变成了通用导出的逻辑了,依次循环,很简单。
不过有一点,我们需要寻找一个起点,那肯定就是入口文件么,即0
号模块,因此,有了以下实现:
(function(modules) {
function load(id) {
//2
const [factory, mapping] = modules[id];
//3
function require(relativePath) {
return load(mapping[relativePath]);
}
//4
const module = {
exports: {}
}
//5
const result = factory(require, module, module.exports);
if (module.exports && Object.getOwnPropertyNames(module.exports).length === 0) {
return result;
}
//6
return module.exports;
}
//1
return function() {
return load(0);
}
})({${modules}})
第 1 步: 从根模块开始。
第 2 步: 取出module
里的factory
和mapping
。
第 3 步: 自定义require
方法,递归执行factory
,这里闭包了2
里的mapping
第 4 步: 自定义导出对象,期待mutable
操作。
第 5 步: 真正执行当前模块的factory
。
第 6 步: 返回4
步的对象。
考虑到打包后的代码量,我们用一个很小的工程作为测试:
main.js
const isArray = require('./util');
const arr = [1,2,3];
console.log(`[1,2,3] is array: ${isArray(arr)}`);
./util
const isArray = arr => arr instanceof Array;
module.exports = isArray;
打包后(略有删减):
(function (modules) {
function load(id) {
const [factory, mapping] = modules[id];
function require(relativePath) {
return load(mapping[relativePath]);
}
const module = {
exports: {},
};
const result = factory(require, module, module.exports);
if (
module.exports &&
Object.getOwnPropertyNames(module.exports).length === 0
) {
return result;
}
return module.exports;
}
return function () {
return load(0);
};
})({
0: [
function (require, module, exports) {
const isArray = require("./util");
const arr = [1, 2, 3];
console.log(`arr is array: ${isArray(arr)}`);
},
{ "./util": 1 },
],
1: [
function (require, module, exports) {
const isArray = (arr) => arr instanceof Array;
module.exports = isArray;
},
{},
],
})();
在Node.js
或浏览器中执行结果:
[1,2,3] is array: true
至此,我们已经可以打包一个小型的纯js
项目了,尽管它还有非常多的问题(@_@)
6 优化
一个好的打包工具是一定需要考虑很多细节以及性能的,虽然笔者无法做到像webpack
这样优秀,但是基于上面的实现,还是能提出一些优化的建议的。
- 1.缓存
我们在建立资源时(createAsset
方法),由于不同的文件也许会导入同样的资源A
,那么我们没有必要多次创建A
,毕竟建立A
的历程还是很长的。因此如果有一个cache
对象的话,简直就是事半功倍。
console.log(`Start extracting: ${revisedPath}`);
if (cache[revisedPath]) {
asset.mapping[relativePath] = cache[revisedPath].id;
} else {
const depAsset = createAsset(revisedPath);
cache[revisedPath] = depAsset;
asset.mapping[relativePath] = depAsset.id;
}
- 2.umd
我们目前打包输出的bundle
结构如下:
(function(modules) {
function load(id) {
...
return module.exports;//1
}
})(modules)
很显然 1 处的return
显得几乎毫无意义,因为没有直接的办法能够接得住这个return
的结果,它就像是你在浏览器的console
里执行了一个函数var result = do()
,这种方式叫做var
打包。
其实大部分情况下,比如React
的项目,不关心这个也是没有问题的,因为chunk
之间的调用关系已经被webpack
组织好了,并不需要你自己去管理最终打包的返回值。
但有时候我们为了兼容其他环境或者确实是想拿到这个打包后的结果(代码分离,微前端的拆分等),那我们就需要考虑更完善的兼容方案了,这是umd
。
我们只需要简单的封装一层即可:
(function (root, factory) {
//commonjs2
if (typeof module === "Object" && typeof exports === "Object")
module.exports = factory();
//commonjs1
else if (typeof exports === "Object") exports["dummy"] = factory();
else root["umd-test"] = factory();
})(window, (function(modules) {
function load(id) {
...
return module.exports;//1
}
})(modules))
)
ps: 笔者这里忽略了 AMD。
- 配置文件
有几个重要的信息还是有必要抽离出来,这里笔者参考了webpack
,˙ 抽离了pack.config.js
文件,最基本的配置如下:
module.exports = {
entry: './main.js',
output: {
filename: 'chunck.js',
library: 'umd-test',
libraryTarget: 'umd'
},
presets: [
'@babel/preset-env'
]
}
- 代码分离
笔者多次提到了dynamicImport
这个语法,其实我这里用了一种比较偷懒的方式实现了代码分离。
首先代码分离必须配置library
的名字(不用解释了吧),在遍历AST
时,我就记录了哪些资源是需要异步加载的。
const dynamicDeps = {};
if (name === 'dynamicImport') {
const revisedPath = buildPath(relativePath, path.dirname(filename), config);
dynamicDeps[revisedPath] = '';
}
traverse(ast, {
...
if (name === 'dynamicImport') {
const revisedPath = buildPath(relativePath, path.dirname(filename), config);
dynamicDeps[revisedPath] = '';
}
...
});
dynamicDeps
里的key
就表明这个路径的资源是异步模块,由于我还需要在最终阶段修改它,所以暂时没设置它的value
。
const {
code
} = babel.transformFromAstSync(
ast,
null, {
plugins: [
dynamicImportPlugin
],
presets,
}
);
这样我在打包阶段就可以和正常的模块一起输出:
function bundle(assets) {
...
if (dynamicDeps.hasOwnProperty(revisedPath)) {
//code split here:
//1.assume that the dynamic module does't have mapping
//2.and not allowed to import the same moudle in other place
asyncModules.push({
prefix: `${id}.`,
content: buildDynamicFactory(id, assets[revisedPath].code)
});
return result;
}
return [
...normalModules,
...asyncModules,
]
}
这里我还用到了 buildDynamicFactory
, 它实现了一个类jsonp
的promise
:
buildDynamicFactory: function (id, code) {
return `(self || this)['jsonpArray']['${id}'] = function(require, module, exports) {
${code}
}`
}
只要异步模块被调到,它的factory
就会被注册到全局jsonpArray
对象上,key
为模块的id
,value
为模块的factory
。
但在这之前还需要知道如何寻找对应的异步模块,回忆上面的load
函数,我需要有如下改造:
function load(id) {
if (!modules[id]) {
return (function (id) {
window["jsonpArray"] = window["jsonpArray"] || {};
const script = document.createElement("script");
script.src = `/dist/${id}.chunck.js`;
document.body.appendChild(script);
return new Promise(function (res, rej) {
script.onload = function () {
const factory = window["jsonpArray"][id];
const module = {
exports: {},
};
factory(null, module, module.exports);
res(module.exports);
};
});
})(id);
}
...
return module.exports;
}
当在modules
里找不到对应模块时,该模块就是异步模块,我会封装一个promise
,当请求到异步模块后,它自己会完成注册,我只需要异步返回下factory
执行后的结果即可。
比如,源代码如果为:
dynamicImport('./api')
.then(res => console.log(`dynamic module response: ${JSON.stringify(res.default())}`));
会被转译为:
require('./api')
.then(res => console.log(`dynamic module response: ${JSON.stringify(res.default())}`));
注意:此时这个require
将会返回的是一个promise
(参考上面的load
函数的修改)。
你可能见惯了import('xxx').then
的写法,觉得笔者这样改造很怪异,但我想说,语法还不就是人定的么,自己怎么舒服怎么来嘛。
- 其他
- 实现更复杂的路径解析
这里笔者只是实现了寻找index.js
和补全文件后缀的简单解析逻辑,更好的方案应该支持自定义node_modules
,自定义alias
等等。
- 支持 json 导入
对于纯文本类型的文件(.yml
, .txt
, .md
, .json
...)可以考虑后期支持。
- 支持 css/scss
这里默认我只处理了js
文件,像css
,scss
,甚至ts
等等可以考虑支持。
7 发布
为了让这个小轮子工程化一些,笔者也发布了简单的cli
:
npm i -g @dummmy/pack-cli
cd your-project
touch pack-config.js
pack