探索webpack源码(四)--- compiler.js(上) 2018-04-26

上一章是探索完Tapable的使用方式,相信大家干翻了前几个boss.js,已经收刮到不少装备,也升了不少级了,有把属性点加在智力上吗?没有的话可能要save/load一下了,回到第一章重新开始加点了哦哈哈哈哈。

把属性点加在智力上的就继续到下一张地图的boss吧,今天是来到compiler.js这张地图。

这里主要是写compiler的运作方式,咱们开始刷怪吧。


我们先从constructor下手吧,从顺序来说不应该先看这里,但是最后还是会回到这里,所以还是先科普一下吧。

class Compiler extends Tapable {
  constructor() {
    // something code ...
    this.hooks = {
      // a pile of hooks
    }
    // something code ...
  }
  otherMethods() { 
    // something code ...
  }
}

为什么要先介绍constructor呢,主要是因为compiler.js主要就是把成个编译流程,通过Tapable的钩子写好了,Tapable在 探索webpack源码(三)已经介绍过了。

compiler.js的核心就在于constructor的this.hooks钩子里,这里定义了许多不同阶段的钩子,了解完这里以后,我们就可以继续往下看了。

探索webpack源码(一)中最后的代码块里,来一波回忆杀:

function processOptions(options) {
    // 各种if else 过滤和配置
    // something code...
    let compiler;
    try {
        // 运行webpack函数,返回一个compiler对象
        compiler = webpack(options); 
    } catch (err) {
        // something code...
    }
    // 执行compiler中的run,开始编译。
    compiler.run(compilerCallback);
}

没错就是 compiler.run 这个api,说明在命令行输入webpack的时候,进入编译模式走的就是这一段代码。

// webpack-cli.js
let compiler = webpack(options); 
compiler.run(compilerCallback);

在webpack-cli.js已经把webpack实例化,得到了compiler,然后执行了run方法。

所以我们看完constructor就看run方法:

// 1
const startTime = Date.now();

// 2
const onCompiled = (err, compilation) =>  {
  // something code;
};
// 3
this.hooks.beforeRun.callAsync(this, err => {
  // something code;
});

run方法里面主要就是这三段话。
1、startTime就是用来计算编译器所消耗时间的初始时间点。
2、当编译完成后需要执行的函数,处理编译完成后的事情。
3、编译钩子的开端。

这里主要讲的顺序也是从第3点的beforeRun钩子开始讲,讲完整个第3点后,再开始讲第2点编译完成后的函数。

第3点这里的代码也不多,就直接全部贴上来吧:

this.hooks.beforeRun.callAsync(this, err => {
    if (err) return callback(err);

    this.hooks.run.callAsync(this, err => {
        if (err) return callback(err);

        this.readRecords(err => {
            if (err) return callback(err);

            this.compile(onCompiled);
        });
    });
});

讲真,我把源码看到这里的时候是一脸懵逼,为啥 async钩子 只接收一个参数的时候,还可以带一个 error-first 风格的回调函数?

而我用各种IDE去搜索,最后都只找到 beforeRun.tap 的方式来绑定tapable事件,这里我一度是认为IDE搜索不全面,然后手动找了半天源码也无果,仔细思考也无果(因为也想不到除了webpack内部还有哪里会绑定beforeRun这个钩子),然后再去看doc,咦?还真有这种用法。

最后自己创建了一个文件才搞清楚,用tap绑定后,callAsync时,最后一个参数会接收一个 error-first 风格的回调函数。只有async钩子并且用tap绑定才有哦。

这一段思维上的bug也更新在 探索webpack源码(三)--- Tapable插件使用 里头。(我真的没有在给自己卖广告,只是方便你们阅读,逃。

废话了那么多,现在进入正题:
上面的代码段只有俩钩子,分别是beforeRun和run。
beforeRun:异步钩子,用于运行前。
run:异步钩子,用于运行时。

它们都接收一个 "compilation" 作为参数,这个可以在constructor的this.hooks里找到定义,我们来拆解一下这部分代码:

// this.hooks.beforeRun
// this === class Compiler
// callback === webpack-cli.js定义的一个compilerCallback函数。
// 似乎用来处理编译完成输出用的,有输出流也有hash处理,没细看。
//(有挺多callback传进来的,目前我按着顺序来看就是这个callback)

// 先接收了自己,再接收一个回调函数
// 如果beforeRun.tap里面有错误,就停止编译,将错误返回出去处理。
this.hooks.beforeRun.callAsync(this, err => {
  if(err) return callback(err);
  // somthingcode ...
})

// 同理
this.hooks.run.callAsync(this, err => {
  if(err) return callback(err);
  // something code...
})

这样基本的两个钩子都弄懂了,可是为什么要这么写呢?我感觉是为了更好的把代码模块化吧,这里就是骨架,把 beforeRun,run 这个流程骨架定义好了,beforeRun 要做什么,run 要做什么,就由得用户自己去填了,这个应该是面向切面编程吧,跟建房子一样,钢筋搭好了,剩下的就是填水泥了(填代码了),个人愚见哈。

上面说的可能抽象了一点,下面我们可以看看给beforeRun.tap过事件,和run.tap过事件的js,因为不是我现在探索的重点,我就把几个js都放一个代码块了:

// NodeEnvironmentPlugin.js
compiler.hooks.beforeRun.tap("NodeEnvironmentPlugin", compiler => {
  if (compiler.inputFileSystem === inputFileSystem) inputFileSystem.purge();
});
// CachePlugin.js
compiler.hooks.run.tapAsync("CachePlugin", (compiler, callback) => {
  // something code...
});

以上代码块就是用来 "填充" 刚刚写好的 "骨架" ,分别都是由其他js文件,作为插件的形式在对应的 "生命周期",或者说是 "骨架的节点"来进行填充你想要的代码,是不是有点豁然开朗的感觉?


这次就到这里吧。。还有很多东西没写完,写的有点久了,太长看着也很恶心。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349

推荐阅读更多精彩内容