从白盒到黑盒-开发自定义webpack插件记录

之前很长一段时间,对webpack有一种畏惧的心理,觉得里面配置复杂,稍微写错某个地方就会导致本地服务跑不起来,样式加载错误,less没有被编译,ES6语法没有被编译。。都是一把辛酸泪。后来慢慢弄清entry,output,然后慢慢加一些loader,比如要开启CSS module功能,比如要对某个资源文件编译成JS,学会用在webpack里面加上plugin,让项目的webpack功能更加强大。但是这一切都是停留在简单使用上,现在我终于尝试去探究webpack内部机制,去利用webpack强大的可配置性做一些定制化的插件。

本文用词比较通俗,如果表述过于小白,敬请见谅。实在是因为webpack整套流程和机制过于精妙,我难窥一二。

怎么去了解和尝试写一个webpack插件

  1. 首先要写一个工厂函数,将这个函数的实例传入webpack的plugins属性
const Plugin = require('./plugin')
module.exports = {
    plugins: [
        new Plugin
    ]
}
  1. 这个工厂函数需要有apply方法,以下为es6写法的该构建函数
export default class DefPlugin {
    constructor(name) {}
    apply(compiler) {}
}
  1. 重点在于这个compiler对象了,它是webpack在构建时传入插件的实例对象

代表了webpack完整的构建流程。该对象在启动webpack时就被一次性创建,由webpack组合所有的配置项(包括原始配置,加载器和插件)构建生成。当在webpack环境中应用一个插件时,插件会收到compiler的引用,通过使用compiler,插件就可以访问到整个webpack的环境(包括原始配置,加载器和插件)。

然后它有很多事件钩子,类似生命周期,在构建的某个生命周期会触发对应的事件钩子,而我们写插件无非就是对使用webpack打包的文件进行自定义的处理,那我们要在合适的事件钩子上注册事件,在compiler对象上注册事件的方法为plugin,当然这是tapable0.2的写法,对1.x写法有兴趣的可以查询文档,方法如下:

apply(compiler) {
    compiler.plugin('compilation', (compilation) => {
       // ...
    })
}
  1. 好,已经知道compiler了,那么compilation又是个什么东西...

compilation--构建过程:compilation对象在compiler的compile方法里创建,它代表了一次单一的版本构建以及构建生成资源的汇总,compilation对象负责组织整个打包过程,包含了每个构建环节及输出环节所对应的方法。该对象内部存放着所有module、chunk、生成的assets以及用来生成最后打包文件的template的信息
当运行webpack-dev-server时,每当检测到一个文件变化,就会创建一次新的编译,从而生成一组新的编译资源。

webpack专门提供了一个compilation钩子,在这里可以获取到compilation对象,我们可以通过compilation对象上的属性做太多事情了,所有项目里的module在这里,chunk在这里...比如我要给改变我的某个module的值,我可以这样做

// 讲真这就是一个完整的自定义插件了,它可以把叫做test.js的module的内容的world字段全局替换为lynn
apply(compiler) {
    compiler.plugin('compilation', (compilation) => {
        compilation.moduleTemplate.plugin('module', (source, module, options, dependencyTemplates) => {
            if (/test.js/.test(module.request)) {
                let newSource = source.source().replace(/world/g, 'lynn')
                return newSource
            } else {
                return source
            }
            return module
        })
    })
}
  1. 好吧...又出现新名词ModuleTemplate,所有的module资源都是要经过模板包装一下输出,compilation上有四个子类,子类上有相应的方法,可以监听事件来出来输出的资源
    image.png

    比如我想改变某个module的代码,可以这样,每一个module都会触发一次moduleTemplate的module事件,那么直接在这里做一个判断,对想要改变的module进行source改造(这里不显示返回module和source是不行的)
    image.png

    我也可以在mainTemplate中改变整个bundle文件的源码
    image.png

compiler事件钩子

image.png

compilation事件钩子

image.png

关于tapable

webpack 的插件架构主要基于Tapable实现的,Tapable 是 webpack 项目组的一个内部库,主要是抽象了一套插件机制,而tapable的精妙之处在于可以玩转任何插件。

  1. webpack 源代码中的一些 Tapable 实例都继承或混合了 Tapable 类。Tapable 能够让我们为 javaScript 模块添加并应用插件。 它可以被其它模块继承或混合。
  2. 它类似于 NodeJS 的 EventEmitter 类,专注于自定义事件的触发和操作。 除此之外, Tapable 允许你通过回调函数的参数访问事件的生产者。
  3. webpack中很多对象实例都继承了tapable类,暴露了一个plugin方法,可以用来监听某个事件
  4. 自定义插件需要有一个apply方法,因为插件实例传入webpack后,webpack会调用实例的apply方法,传入compiler对象,拿到这个对象就可以访问webpack构建过程中的信息了,比如options,module应有尽有,其中在合适的事件里可以获取到compilation对象,它代表了本次编译过程,其中又有很多事件钩子供我们去挂载事件

敲黑板划重点

如果没有在文档中有可能找不到合适的事件钩子,那么这时可以去阅读源码找到钩子

关于webpack的构建流程 还要继续学习

附上淘宝神图一张webpack构建流程图和传送门一个链接

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

推荐阅读更多精彩内容