webpack 源码从零开始：apable模型
前文
最近在看webpack的源码，发现有个比较头疼的点是：代码看起来非常跳跃，往往看不到几行就插入一段新内容，为了理解又不得不先学习相关的前置知识。层层嵌套之后，发现最基础的还是tapable模型，因此先对这部分的内容做一个介绍。
引子-webpack的基本流程
Webpack的流程可以分为以下三大阶段：
初始化：启动构建，读取与合并配置参数，加载 Plugin，实例化 Compiler。这个compile对象会穿行在本次编译的整个周期。
编译：从 Entry 发出，针对每个 Module 串行调用对应的 Loader 去翻译文件内容，再找到该 Module 依赖的 Module，递归地进行编译处理。
输出：对编译后的 Module 组合成 Chunk，把 Chunk 转换成文件，输出到文件系统。
在这个过程中，最核心的就是插件化的设计： 在不同的阶段执行相应的一些插件，来执行某些功能。
而这里的阶段，指的就是hook。 理论太抽象，来看一段webpack的源码(4.x版本):
// webpack/lib/MultiCompiler.js
const { Tapable, SyncHook, MultiHook } = require("tapable");
class MultiCompiler extends Tapable {
constructor(compilers) {
super();
this.hooks = {
done: new SyncHook(["stats"]),
invalid: new MultiHook(compilers.map(c => c.hooks.invalid)),
run: new MultiHook(compilers.map(c => c.hooks.run)),
watchClose: new SyncHook([]),
watchRun: new MultiHook(compilers.map(c => c.hooks.watchRun)),
infrastructureLog: new MultiHook(
compilers.map(c => c.hooks.infrastructureLog)
)
};
}
/// 省略其他代码
}这是compile的构造函数，有几个注意点：
- 显示继承了Tapable，也就是本文的话题对象
- 注意看this.hooks部分的内容: done invalid, run, watchClose 等等都是内置的生命周期，具体的代码暂时不去关心。
这部分代码主要是为了说明一个思路： webpack 的生命周期hook，实际上是一个个插件的集合，代表的含义是，在某个阶段需要挂载某些插件。
到这里，脑海里有这种大概雏形就好，接下来我们开始介绍Tapable。
Tapable机制初探
Tapable的核心思路有点类似于nodejs中的events，最基本的发布/订阅模式。
const EventEmitter = require('events');
const myEmitter = new EventEmitter();
// 注册事件对应的监听函数
myEmitter.on('安歌发布新文章', (title, tag) => {
console.log("前去围观并吐槽",title, tag)
});
// 触发事件 并传入参数
myEmitter.emit('安歌发布新文章',’标题tapable机制‘, '标签webpack');这个结构很简单也很清晰：
- events.on 用于注册要监听的事件和对应的毁掉方法
- events.emit 用于触发对应的事件
tapable的核心用法与此相似，那为什么多次一举要使用它呢？
根据前面的demo，不妨假设一下，如果我们注册了很多事件，比如event.on(’起床‘),event.on(’吃饭‘),event.on(’上班‘)等等，那事件之间可能就存在一些依赖关系，比如要先起床然后才能上班这样的时序依赖，而tapable就可以帮助我们很方便的管理这些关系。
基本用法
接下来用一个前几天参加的公司中秋晚会的例子，来简单说明一下Tapable的用法：
我把自己的参加流程分成以下阶段：
-
晚宴前
- 检查着装
- 乘坐班车到酒店
-
晚宴中
- 用餐并欣赏表演
- 在当前桌进行博饼
- 如果成为当前桌状元，那么就留下来博王中王,
-
晚宴后
- 拍一些照片，打车回家
- 用拍好的照片发朋友圈纪念
那么先写个全局demo：
// 1. 引入 tapable ，先不管具体的钩子类型
const {
SyncHook,
SyncBailHook,
SyncWaterfallHook,
} = require("tapable");
// 2. 定义不同阶段对应的钩子，
// 钩子: 晚宴前
let beforeDinner = new SyncHook(["stageName"]);
// 钩子：晚宴中
let atTheDinner = new SyncBailHook(["stageName"]);
// 钩子 晚宴后
let afterDinner = new SyncWaterfallHook(["stageName"]);
// 3. 为不同阶段注册事件，这里先写出晚宴前的事件
beforeDinner.tap('检查着装', (stageName)=>{
console.log(`${stageName}: 检查着装`)
})
beforeDinner.tap('乘坐班车到酒店', (stageName)=>{
console.log(`${stageName}: 乘坐班车到酒店`)
})
// 每个阶段触发自身需要执行的事件
beforeDinner.call('晚宴前');
atTheDinner.call('晚宴中');
afterDinner.call('晚宴后');
// 输出结果：
// 晚宴前: 检查着装
// 晚宴前: 乘坐班车到酒店
// ... 省略后面的输出这个demo简单的定义了三个阶段，先不去关具体的hook类型，了解下整体的结构：
- beforeDinner在实例化时，使用数组声明了参数stageName, 这个地方的参数类型仅仅作为接口定义的目的使用，为了方便触发的时候传入对应的参数；
- call方法其实就类似前文的emit，与之不同的是，event.emit表示事件触发，而hook.call表示当前钩子要开始执行钩子上注册的所有事件。(当然我们只注册了晚宴前的2个事件)
- hook.call(param)执行之后，该hook对应的事件就按照注册顺序以及特定规则（具体规则后面说明，暂时略过）依次执行，因此上面的beforeDinner.call('晚宴前');会输出对应的阶段名称和事件名称。
到这里，我们已经用上了最基本的tapable了。回顾下它和events最大的区别：
tapable不仅提供了事件的注册和执行，还用不同的Hook 将事件进行分类(这里例子用三个阶段将基础事件分类)
SyncBailHook
接下来就是晚宴中的事件，这里有个注意点：晚宴中的第三个事件”如果成为当前桌状元，那么就留下来博王中王“是一个带有前提条件的事件，所以我们用了SyncBailHook，并且这么注册事件:
atTheDinner.tap('用餐并欣赏表演', (stageName) => {
console.log(`${stageName}: 用餐并欣赏表演`);
})
atTheDinner.tap('在当前桌进行博饼', (stageName) => {
console.log(`${stageName}: 在当前桌进行博饼`);
// 关键伪代码
let getChampion = false //如果获得状元
if(!getChampion){
console.log(`${stageName}: 没有获得当前桌状元，不需要参与博王中王`); // 注意这里的return
return '提前结束！';
}
})
atTheDinner.tap('博王中王', (stageName) => {
console.log(`${stageName}: 博王中王`);
})
SyncBailHook翻译过来意思是“熔断类型的钩子”，作用就像保险丝，一旦有危险，则启动保护（一旦该钩子的某个事件，执行返回除了undefined以外的值，后面注册的事件就不再执行）。正如前面的例子中，如果在“当前桌子博饼”中没有成功搏到“状元”，就不会进行后面的“搏王中王”事件。常用于处理某些需要条件判断才触发的事件。
SyncWaterfallHook
晚宴之后的事件，与前面不用的地方在于：事件2发朋友圈 用的是事件1中所拍的照片，换句话说后面的事件依赖于前面事件的执行结果。所以可以这么写：
afterDinner.tap('回家前拍照', (stageName) => {
console.log(`${stageName}: 拍一些照片，打车回家`);
let pictures = ['image1','image2'];
return pictures;
})
afterDinner.tap('回家后发朋友圈', (pictures)=> {
// 注意这里的内置参数 不再是stageName 而是pictures
return console.log(`回家后，用${pictures}:发朋友圈`);
})实例化afterDinner时使用了SyncWaterfallHook，顾名思义，这种瀑布式的钩子，作用就是在执行该钩子内注册的事件时，会把每个阶段的执行结果传递给后面的阶段。
小结
这部分我们介绍了tapable的基本用法和三种基本类型的hook，大概可以总结一下：
hook表示事件的集合，hook的类型决定了注册在这个hook的事件如何执行
异步类型的hook
总览
开胃菜结束，接下来要真正开始系统化的了解tapable了，（好消息是如果前面的例子都看懂了，后面的学起来会非常简单，坏消息是：又要涉及前端最棘手的问题之一--异步）
先来一览所有的hook类型：
总体上，hook类型分成同步和异步两大类，异步再分为异步串行和异步并行。
先前已经介绍了同步hook里面的前三种。第四种SynloopHook也简要介绍下：
假设写文章这个事情，分成校对和发表两个步骤，校对必须3次以上，才可以执行发表事件：
// 当监听函数被触发的时候，如果该监听函数返回true时则这个监听函数会反复执行，如果返回 undefined 则表示退出循环
let writeArticle = SyncLoopHook();
let count = 0;
writeArticle.tap('校对',()=>{
console.log('执行校对', count++)
if(count<3){
return true; // 没有达到3次则继续校对
}
return
})
writeArticle.tap('发表',()=>{
console.log('发表')
})
异步并行 AsyncParallelHook
异步的hook，注册和触发可以用tapAsync/callAsync和tapPromise/promise两种语法，写法上略有不用。直接上demo:
// AsyncParallelHook 钩子：tapAsync/callAsync 的使用
const { AsyncParallelHook } = require("tapable");
// 创建实例
let asyncParallelHook = new AsyncParallelHook(["demoName"]);
// 注册事件
console.time("time");
asyncParallelHook.tapAsync("异步事件1", (demoName, done) => {
setTimeout(() => {
console.log("1", demoName, new Date());
done(); //需要注意的是这里的`done`方法
}, 1000);
});
asyncParallelHook.tapAsync("异步事件2", (demoName, done) => {
setTimeout(() => {
console.log("2", demoName, new Date());
done();
}, 2000);
});
asyncParallelHook.tapAsync("异步事件3", (demoName, done) => {
setTimeout(() => {
console.log("3", demoName, new Date());
done();
console.timeEnd("time");
}, 3000);
});
// 触发事件，让监听函数执行
asyncParallelHook.callAsync("异步并行", () => {
// 只有当前钩子的所有事件都执行done 才进入这个callback
console.log("complete");
});
// 输出
// 异步事件1 异步并行
// Sun Sep 08 2019 21:24:12 GMT+0800 (GMT+08:00) {}
// 异步事件2 异步并行
// Sun Sep 08 2019 21:24:13 GMT+0800 (GMT+08:00) {}
// 异步事件3 异步并行
// Sun Sep 08 2019 21:24:14 GMT+0800 (GMT+08:00) {}
// complete
// time: 3007.266845703125ms
// time: 3007.640ms 需要注意的是这里的done方法， 每个注册的的事件都可以调用到这个done方法，这个方法的作用是：向对应的hook实例告知，当前的异步事件完成，只有当所有的事件回调都执行了done方法，才会进入钩子本身的回调函数(demo中的console.log("complete");)
从例子中的计时情况来看，很明显所有的事件是并行的 -- 事件1 2 3分别需要1s 2s 3s， 最终执行完也只花了3s。
用tapPromise/promise来写的话，如下:
asyncParallelHook.tapPromise("异步事件1", (demoName) => {
return new Promise((resolve, reject) => {
setTimeout(() => {
console.log("1", demoName, new Date());
resolve("1");
}, 1000);
});
});
// ...省略重复代码
asyncParallelHook.promise("异步并行").then(() => {
console.log("最终结果", new Date());
}).catch(err => {
console.log("发现错误", new Date());
});区别在于:
- 使用tapPromise注册时，回调函数必须返回一个promise
- 使用tabAsync注册使用done表示当前执行完成，使用tapPromise时则只要使用resolve()即可
- 如果其中一个事件没有resolve, 而是reject(error)，那么会进入asyncParallelHook的catch而不是then
这种写法其实很类似ES6中的promise.all,比较好理解
异步串行AsyncSeriesHook
其实到这里，已经一只脚踏进成功的大门了。 异步串行和异步并行的写法，完全一样。只需要简单把前面例子中,实例化的语句改成:
let asyncSeriesHook = new AsyncSeriesHook()然后看看3个异步事件执行完后的事件间隔（并行的时候是3s，串行时总时长变成6s）。
没错，就是这么简单~！
广州VI设计公司https://www.houdianzi.com
引申 -- 实例案例webpack-dev-middleware中tapable的应用
webpack-dev-middleware是一个webpack的插件，作用是监听webpack的编译变化并写入到内存中。 核心代码：
// webpack-dev-middleware/lib/context.js
const context = {
state: false,
webpackStats: null, //
callbacks: [],
options,
compiler,
watching: null,
forceRebuild: false,
};
function invalid(callback) {
if (context.state) {
context.options.reporter(context.options, {
log,
state: false,
});
}
// We are now in invalid state
context.state = false;
if (typeof callback === 'function') {
callback();
}
}
// 关键代码 利用compile的hook 观察编译变化 并插入操作
context.compiler.hooks.invalid.tap('WebpackDevMiddleware', invalid);
context.compiler.hooks.run.tap('WebpackDevMiddleware', invalid);
context.compiler.hooks.done.tap('WebpackDevMiddleware', done);
context.compiler.hooks.watchRun.tap(
'WebpackDevMiddleware',
(comp, callback) => {
invalid(callback);
}
);核心的代码就是使用webpack提供的内置hook watchRun来插入自定义的操作（检查编译情况，生成临时结果到内存）
总结
呼~ tapable的内容大概写完了，本文介绍了同步的几种钩子，和异步的2种代表性的钩子，至于异步并行熔断等等，就是前面介绍的钩子的合成，比较简单。回顾一下主要的内容：
- 同步hook触发后，按照事件注册顺序依次调用，并根据钩子类型，有一些特殊行为（bail loop）；
- 异步的hook有tapAsync/callAsync和tapPromise/promise两种使用方式，并且都可以观察事件整体执行结果；
- 异步串行和异步并行的区别，在于注册的事件依次执行（前一个完成才开始执行后一个）还是并发执行；
理解清楚tapable之后，再开始学习webpack的源码，会相对顺畅一些。
