# 前期准备

# 从使用的角度来看插件

好了,我已经准备好阅读的这篇文章然后写一个炒鸡牛x的插件了,赶紧的。

额,等等,在这之前我们不是得知道需要怎么去做吗?我们总是听到的插件插件的,它到底是个啥啊?

对象?函数?类?

小伙伴们不妨结合我们已经用过的一些插件来猜猜,比如HtmlWebpackPlugin,我们会这样使用它:

module.exports = {
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    })
  ]
}

可以看到,这很明显的就是个构造函数,或者是一个类嘛。我们使用new就可以实例化一个插件的对象。并且,这个函数或者类是可以让我们传递参数进去的。

那你脑子里是不是已经脑补出一个轮廓了呢?

function CustomPlugin (options) {}

// or
class CustomPlugin {
  constructor (options) {}
}

# 从构建的角度来看插件

知道了plugin大概的轮廓,让我们从构建的角度来看看它。插件不同于loader一个很大的区别就是,loader它是一个转换器,它只专注于转换这一个领域,例如babel-loader能将ES6+的代码转换为ES5或以下,以此来保证兼容性,那么它是运行在打包之前的。

plugin呢?你会发现市场上有各种让人眼花缭乱的插件,它可能运行在打包之前,也可能运行在打包的过程中,或者打包完成之后。总之,它不局限于打包,资源的加载,还有其它的功能。所以它是在整个编译周期都起作用。

那么如果让我们站在一个编写插件者的角度上来看的话,是不是在编写的时候需要明确两件事情:

  • 我要如何拿到完整的webpack环境配置呢?因为我在编写插件的时候肯定是要与webpack的主环境结合起来的
  • 我如何告诉webpack我的插件是在什么时候发挥作用呢?在打包之前?还是之后?也就是我们经常听到的钩子。

所以这时候我们就得清楚这几个硬知识点:

  • compiler 对象代表了完整的 webpack 环境配置。这个对象在启动 webpack 时被一次性建立,并配置好所有可操作的设置,包括 options,loader 和 plugin。当在 webpack 环境中应用一个插件时,插件将收到此 compiler 对象的引用。可以使用它来访问 webpack 的主环境。

  • compilation 对象代表了一次资源版本构建。当运行 webpack 开发环境中间件时,每当检测到一个文件变化,就会创建一个新的 compilation,从而生成一组新的编译资源。一个 compilation 对象表现了当前的模块资源、编译生成资源、变化的文件、以及被跟踪依赖的状态信息。compilation 对象也提供了很多关键时机的回调,以供插件做自定义处理时选择使用。

  • 钩子的本质其实就是事件

# 案例准备

老规矩,为了能更好的让我们掌握本章的内容,我们需要本地创建一个案例来进行讲解。

创建项目的这个过程我就快速的用指令来实现一下哈:

mkdir webpack-custom-plugin && cd webpack-custom-plugin
npm init -y
cnpm i webpack webpack-cli clean-webpack-plugin html-webpack-plugin --save-dev
touch webpack.config.js
mkdir src && cd src
touch index.js

(mkdir:创建一个文件夹;touch:创建一个文件)

OK👌,此时项目目录变成了:

 webpack-custom-plugin
    |- package.json
    |- webpack.config.js
    |- /src
      |- index.js

接着让我们给src/index.js随便加点东西意思一下,省得太空了:

src/index.js

function createElement () {
  const element = document.createElement('div')
  element.innerHTML = '孔子曰:中午不睡,下午崩溃!孟子曰:孔子说的对!';

  return element
}
document.body.appendChild(createElement())

webpack.config.js也简单的来配置一下吧,这些应该都是基础了,之前有详细说过了哟:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: '[name].bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    }),
    new CleanWebpackPlugin()
  ]
}

clean-webpack-plugin插件会在我们每次打包之前自动清理掉旧的dist文件夹

另外还需要在package.json中配置一条打包指令哈:

{
  "script": {
    "build": "webpack --mode development"
  }
}

这里的"webpack"实际上是"webpack --config webpack.config.js"的缩写,这点在基础篇中也有说到咯。

--mode development就是指定一下环境为开发环境,因为我们后续可能有需要看到打包之后的代码内容,如果指定了为production的话,那么webpack它会自动开启UglifyJS的也就是会对我们打包成功之后的代码进行压缩输出,那一坨一坨的代码我们就不利于我们查看了。

# No1-webpack-plugin案例

好的了,基本工作已经准备完毕了,让我们动手来编写我们的第一个插件吧。

这个插件案例主要是为了帮助你了解插件大概的创建流程。

# 传统形式的compiler.plugin

从易到难,让我们来实现这么一个简单的功能:

  • 当我们在完成打包之后,控制台会输出一个"good boy!"

在刚刚的案例目录中新建一个plugins文件夹,然后在里面创建上我们的第一个插件: No1-webpack-plugin

 webpack-custom-plugin
  |- package.json
  |- webpack.config.js
  |- /src
    |- index.js
+ |- /plugins
+   |-No1-webpack-plugin.js

现在依照前面所说的插件的结构,以及我们的需求,可以写出以下代码:

plugins/No1-webpack-plugin.js:

// 1. 创建一个构造函数
function No1WebpackPlugin (options) {
  this.options = options
}
// 2. 重写构造函数原型对象上的 apply 方法
No1WebpackPlugin.prototype.apply = function (compiler) {
  compiler.plugin('done', () => {
    console.log(this.options.msg)
  })
}
// 3. 将我们的自定义插件导出
module.exports = No1WebpackPlugin;

接着,让我们来看看如何使用它,也就是:

webpack.config.js:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
+ const No1WebpackPlugin = require('./plugins/No1-webpack-plugin');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: '[name].bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    }),
    new CleanWebpackPlugin(),
+   new No1WebpackPlugin({ msg: 'good boy!' })
  ]
}

OK👌,代码已经编写完啦,快npm run build一下看看效果吧:

可以看到,控制台已经在夸你"good boy!"了😄。

那么让我们回到刚刚的那段自定义插件的代码中:

plugins/No1-webpack-plugin.js:

// 1. 创建一个构造函数
function No1WebpackPlugin (options) {
  this.options = options
}
// 2. 在构造函数原型对象上定义一个 apply 方法
No1WebpackPlugin.prototype.apply = function (compiler) {
  compiler.plugin('done', () => {
    console.log(this.options.msg)
  })
}
// 3. 将我们的自定义插件导出
module.exports = No1WebpackPlugin;

注意到这里,我们一共是做了这么三件事情,也就是我在代码中的注释。

很显然,为了能拿到webpack.config.js中我们传递的那个参数,也就是{ msg: 'good boy!' },我们需要在构造函数中定义一个实例对象上的属性options

并且在prototype.apply中呢:

  • 我们需要调用compiler.plugin()并传入第一个参数来指定我们的插件是发生在哪个阶段,也就是这里的"done"(一次编译完成之后,即打包完成之后);
  • 在这个阶段我们要做什么事呢?就可以在它的第二个参数回调函数中来写了,请注意这里我们的回调函数是一个箭头函数哦,这也是能够保证里面的this获取到的是我们的实例对象,也就是为了能保证我们拿到options,并成功的打印出msg

所以,现在你的思维是不是已经很清晰了呢?我们想要编写一个插件,只需要这么几步:

  1. 明确你的插件是要怎么调用的,需不需要传递参数(对应着webpack.config.js中的配置);
  2. 创建一个构造函数,以此来保证用它能创建一个个插件实例;
  3. 在构造函数原型对象上定义一个 apply 方法,并在其中利用compiler.plugin注册我们的自定义插件。

那么除了用构造函数的方式来创建插件,是否也可以用类呢?让我们一起来试试,将刚刚的代码改动一下:

plugins/No1-webpack-plugin.js:

// // 1. 创建一个构造函数
// function No1WebpackPlugin (options) {
//   this.options = options
// }
// // 2. 重写构造函数原型对象上的 apply 方法
// No1WebpackPlugin.prototype.apply = function (compiler) {
//   compiler.plugin('done', () => {
//     console.log(this.options.msg)
//   })
// }
class No1WebpackPlugin {
  constructor (options) {
    this.options = options
  }
  apply (compiler) {
    compiler.plugin('done', () => {
      console.log(this.options.msg)
    })
  }
}
// 3. 将我们的自定义插件导出
module.exports = No1WebpackPlugin;

这时候你执行打包指令效果也是一样的哈。这其实也很好理解,class它不就是咱们构造函数的一个语法糖吗,所以它肯定也可以用来实现一个插件啦。

不过不知道小伙伴们注意到了,在我们刚刚输出"good boy!"的上面,还有一段小小的警告:

它告诉我们Tabable.plugin这种的调用形式已经被废弃了,请使用新的API,也就是.hooks来替代.plugin这种形式。

但并不是说上面的文档就不能看了,我们依然还是可以通过阅读它来了解更多插件相关的知识。

# 推荐使用compiler.hooks

既然官方都推荐我们用compiler.hooks了,那我们就遵循呗。不过如果你直接去看Plugin API的话对新手来说好像又有点绕,里面的Tapablecompilercompilecompilation它们直接到底是存在怎样的关系呢?

没关系都会依次的进行讲解。

现在让我们将No1-webpack-plugin使用compiler.hooks改造一下吧:

plugins/No1-webpack-plugin.js:

// 第一版
// function No1WebpackPlugin (options) {
//   this.options = options
// }
// No1WebpackPlugin.prototype.apply = function (compiler) {
//   compiler.plugin('done', () => {
//     console.log(this.options.msg)
//   })
// }
// 第二版
// class No1WebpackPlugin {
//   constructor (options) {
//     this.options = options
//   }
//   apply (compiler) {
      // compiler.plugin('done', () => {
      //   console.log(this.options.msg)
      // })
//   }
// }
// 第三版
function No1WebpackPlugin (options) {
  this.options = options
}
No1WebpackPlugin.prototype.apply = function (compiler) {
  compiler.hooks.done.tap('No1', () => {
    console.log(this.options.msg)
  })
}
module.exports = No1WebpackPlugin;

可以看到,第三版中,关键点就是在于:

compiler.hooks.done.tap('No1', () => {
  console.log(this.options.msg)
})

它替换了我们之前的:

compiler.plugin('done', () => {
  console.log(this.options.msg)
})

让我们来拆分一下compiler.hooks.done.tap('No1', () => {})

  • compiler:一个扩展至Tapable的对象
  • compiler.hookscompiler对象上的一个属性,允许我们使用不同的钩子函数
  • .donehooks中常用的一种钩子,表示在一次编译完成后执行,它有一个回调参数stats(暂时没用上)
  • .tap:表示可以注册同步的钩子和异步的钩子,而在此处因为done属于异步AsyncSeriesHook类型的钩子,所以这里表示的是注册done异步钩子。
  • .tap('No1')tap()的第一个参数'No1',其实tap()这个方法它的第一个参数是可以允许接收一个字符串或者一个Tap类的对象的,不过在此处我们不深究,你先随便传一个字符串就行了,我把它理解为这次调用钩子的方法名。

所以让我们连起来理解这段代码的意思就是:

  1. 在程序执行new No1WebpackPlugin()的时候,会初始化一个插件实例且调用其原型对象上的apply方法
  2. 该方法会告诉webpack当你在一次编译完成之后,得执行一下我的箭头函数里的内容,也就是打印出msg

现在我们虽然会写一个简单的插件了,但是对于上面的一些对象、属性啥的好像还不是很懂耶。想要一口气吃完一头大象🐘是有点难的哦(而且那样也是犯法的),所以接下来让我们来大概了解一下这些Tapablecompiler等等的东西是做什么的😊。

# Tapable

首先是Tapable这个东西,我看了一下网上有很多对它的描述:

  1. tapable 这个小型 library 是 webpack 的一个核心工具
  2. Webpack 的 Tapable 事件流机制保证了插件的有序性,使得整个系统扩展性良好
  3. Tapable 为 webpack 提供了统一的插件接口(钩子)类型定义,它是 webpack 的核心功能库、

当然这些说法肯定都是对的哈,所以总结一下:

  • 简单来说Tapable就是webpack用来创建钩子的库,为webpack提供了插件接口的支柱。

其实如果你去看了它Git上的文档的话,它就是暴露了9个Hooks类,以及3种方法(tap、tapAsync、tapPromise),可用于为插件创建钩子。

9种Hooks类与3种方法之间的关系:

  • Hooks类表示的是你的钩子是哪一种类型的,比如我们上面用到的done,它就属于AsyncSeriesHook这个类
  • tap、tapAsync、tapPromise这三个方法是用于注入不同类型的自定义构建行为,因为我们的钩子可能有同步的钩子,也可能有异步的钩子,而我们在注入钩子的时候就得选对这三种方法了。

对于Hooks类你大可不必全都记下,一般来说你只需要知道我们要用的每种钩子它们实际上是有类型区分的,而区分它们的就是Hooks类。

如果你想要清楚它们之前的区别的话,这里也有找到一个解释的比较清楚的总结:

Sync*

  • SyncHook --> 同步串行钩子,不关心返回值
  • SyncBailHook --> 同步串行钩子,如果返回值不为null 则跳过之后的函数
  • SyncLoopHook --> 同步循环,如果返回值为true 则继续执行,返回值为false则跳出循环
  • SyncWaterfallHook --> 同步串行,上一个函数返回值会传给下一个监听函数

Async*

  • AsyncParallel*:异步并发
    • AsyncParallelBailHook --> 异步并发,只要监听函数的返回值不为 null,就会忽略后面的监听函数执行,直接跳跃到callAsync等触发函数绑定的回调函数,然后执行这个被绑定的回调函数
    • AsyncParallelHook --> 异步并发,不关心返回值
  • AsyncSeries*:异步串行
    • AsyncSeriesHook --> 异步串行,不关心callback()的参数
    • AsyncSeriesBailHook --> 异步串行,callback()的参数不为null,就会忽略后续的函数,直接执行callAsync函数绑定的回调函数
    • AsyncSeriesWaterfallHook --> 异步串行,上一个函数的callback(err, data)的第二个参数会传给下一个监听函数

(总结来源:XiaoLu-写一个简单webpack plugin所引发的思考)

而对于这三种方法,我们必须得知道它们分别是做什么用的:

  • tap:可以注册同步钩子也可以注册异步钩子
  • tapAsync:回调方式注册异步钩子
  • tapPromisePromise方式注册异步钩子

就比如,我现在想要注册一个compile的钩子,根据官方文档,我发现它是SyncHook类型的钩子,那么我们就只能使用tap来注册它。如果你试图用tapAsync的话,打包的话你就会发现控制台已经报错了,比如这样:

(额,不过我在使用compiler.hooks.done.tapAsync()的时候,查阅文档上它也是SyncHook类,但是却可以用tapAsync方法注册,这边也有点没搞明白是为什么,有知道的小伙伴还希望可以评论区留言呀😄)

# compiler?compile?compilation?

接下来就得说一说插件中几个重要的东西了,也就是这一小节的标题里的这三个东西。

首先让我们在官方的文档上找寻一下它们的足迹:

可以看到,这几个属性都长的好像啊,而且更过分的是,compilation竟然还有两个同名的,你这是给👴整真假美猴王呢?

那么这边就对这几个属性做一下说明。

首先对于文档左侧菜单上的compiler钩子和compilation钩子(也就是第一个和第四个)我们在之后称它们为CompilerCompilation好了,也是为了和compile做区分,其实我认为你可以把"compiler钩子"理解为"compiler的钩子",这样会更好一些。

  • Compiler:是一个对象,该对象代表了完整的webpack环境配置。整个webpack在构建的时候,会先初始化参数也就是从配置文件(webpack.config.js)和Shell语句("build": "webpack --mode development")中去读取与合并参数,之后开始编译,也就是将最终得到的参数初始化这个Compiler对象,然后再会加载所有配置的插件,执行该对象的run()方法开始执行编译。因此我们可以理解为它是webpack的支柱引擎。
  • Compilation:也是一个对象,不过它表示的是某一个模块的资源、编译生成的资源、变化的文件等等,因为我们知道我们在使用webpack进行构建的时候可能是会生成很多不同的模块的,而它的颗粒度就是在每一个模块上。

所以你现在可以看到它俩的区别了,一个是代表了整个构建的过程,一个是代表构建过程中的某个模块。

还有很重要的一点,它们两都是扩展至我们上面👆提到的Tapable类,这也就是为什么它两都能有这么多生命周期钩子的原因。

再来看看两个小写的compile和compilation,这两个其实就是Compiler对象下的两个钩子了,也就是我们可以通过这样的方式来调用它们:

No1WebpackPlugin.prototype.apply = function (compiler) {
  compiler.hooks.compile.tap('No1', () => {
    console.log(this.options.msg)
  })
  compiler.hooks.compilation.tap('No1', () => {
    console.log(this.options.msg)
  })
}

区别在于:

  • compile:一个新的编译(compilation)创建之后,钩入(hook into) compiler。
  • compilation:编译(compilation)创建之后,执行插件

# No2-webpack-plugin案例

这个插件案例主要是为了帮你理解Compiler、Compilation、compile、compilation四者之间的关系。

# compile和compilation

还是在上面👆那个项目中,让我们在plugins文件夹下再新增一个插件,叫做No2-webpack-plugin

plugins/No2-webpack-plugin.js:

function No2WebpackPlugin (options) {
  this.options = options
}
No2WebpackPlugin.prototype.apply = function (compiler) {
  compiler.hooks.compile.tap('No2', () => {
    console.log('compile')
  })
  compiler.hooks.compilation.tap('No2', () => {
    console.log('compilation')
  })
}
module.exports = No2WebpackPlugin;

在这个插件中,我分别调用了compilecompilation两个钩子函数,等会让我们看看会发生什么事情。

同时,把webpack.config.js中的No1插件替换成No2插件:

webpack.config.js:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
// const No1WebpackPlugin = require('./plugins/No1-webpack-plugin');
const No2WebpackPlugin = require('./plugins/No2-webpack-plugin');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: '[name].bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    }),
    new CleanWebpackPlugin(),
    // new No1WebpackPlugin({ msg: 'good boy!' })
    new No2WebpackPlugin({ msg: 'bad boy!' })
  ]
}

现在项目的目录结构是这样的:

 webpack-custom-plugin
  |- package.json
  |- webpack.config.js
  |- /src
    |- index.js
  |- /plugins
    |-No1-webpack-plugin.js
+   |-No2-webpack-plugin.js

OK👌,来执行npm run build看看:

哈哈哈😄,是不是给了你点什么启发呢?

我们最终生成的dist文件夹下会有两个文件,那么compilation这个钩子就被调用了两次,而compile钩子就只被调用了一次。

有小伙伴可能就要问了,我们这里的src下明明就只有一个index.js文件啊,为什么最终的dist下会有两个文件呢?

  • main.bundle.js
  • index.html

别忘了,在这个项目中我们可是使用了html-webpack-plugin这个插件的,它会帮我自动创建一个html文件。

为了验证这个compilation是跟着文件的数量走的,我们暂时先把new HtmlWebpackPlugin给去掉看看:

const path = require('path');
// const HtmlWebpackPlugin = require('html-webpack-plugin');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
// const No1WebpackPlugin = require('./plugins/No1-webpack-plugin');
const No2WebpackPlugin = require('./plugins/No2-webpack-plugin');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: '[name].bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    // new HtmlWebpackPlugin({
    //   title: 'custom-plugin'
    // }),
    new CleanWebpackPlugin(),
    // new No1WebpackPlugin({ msg: 'good boy!' })
    new No2WebpackPlugin({ msg: 'bad boy!' })
  ]
}

试试效果?

这时候,compilation就只执行一次了,而且dist中也没有再生成html文件了。

(当然,我这里只是为了演示哈,在确定完了之后,我又把html-webpack-plugin给启用了)

# Compiler和Compilation

想必上面两个钩子函数的区别大家应该都搞懂了吧,接下来就让我们看看CompilerCompilation这两个对象的区别。

通过查看官方文档,我们发现,刚刚用到的compiler.hooks.compilation这个钩子,是能够接收一个参数的:

貌似这个形参的名字就是叫做compilation,它和Compilation对象是不是有什么联系呢?或者说,它就是一个Compilation?。

OK👌,我就假设它是吧,接下来我去查看了一下compilation钩子,哇,这钩子的数量是有点多哈,随便挑个顺眼的来玩玩?额,翻到最下面,有个chunkAsset,要不就它吧:

可以看到这个钩子函数是有两个参数的:

  • chunk:表示的应该就是当前的模块吧
  • filename:模块的名称

接着让我们来改写一下No2-webpack-plugin插件:

src/No2-webpack-plugin.js:

function No2WebpackPlugin (options) {
  this.options = options
}
No2WebpackPlugin.prototype.apply = function (compiler) {
  compiler.hooks.compile.tap('No2', (compilation) => {
    console.log('compile')
  })
  compiler.hooks.compilation.tap('No2', (compilation) => {
    console.log('compilation')
+   compilation.hooks.chunkAsset.tap('No2', (chunk, filename) => {
+     console.log(chunk)
+     console.log(filename)
+   })
  })
}
module.exports = No2WebpackPlugin;

我们做了这么几件事:

  • Compilercompilation钩子函数中,获取到Compilation对象
  • 之后对每一个Compilation对象调用它的chunkAsset钩子
  • 根据文档我们发现chunkAsset钩子是一个SyncHook类型的钩子,所以只能用tap去调用

如果和我们猜测的一样,每个Compilation对象都对应着一个输出资源的话,那么当我们执行npm run build之后,控制台肯定会打印出两个chunk以及两个filename

一个是index.html,一个是main.bundle.js

OK👌,来瞅瞅。

现在看看你的控制台是不是打印出了一大长串呢?这里简写一下输出结果:

'compile'
'compilation'
'compilation'
Chunk {
  id: 'HtmlWebpackPlugin_0',
  ...
}
'__child-HtmlWebpackPlugin_0'
Chunk {
  id: 'main',
  ...
}
'main.bundle.js'

可以看到,确实是有两个Chunk对象,还有两个文件名称。

只不过index.html不是按照我们预期的输出为"index.html",而是输出为了__child-HtmlWebpackPlugin_0,这点猜测是html-webpack-plugin插件本身做了一些处理吧。

# Compiler和Compilation对象的内容

如果大家把这两个对象打印在控制台上的话会发现有一大长串,这边找到了一份比较全面的对象属性的清单,大家可以看一下:

(图片与总结来源:编写一个自己的webpack插件plugin)

Compiler 对象包含了 Webpack 环境所有的的配置信息,包含 optionshookloadersplugins 这些信息,这个对象在 Webpack 启动时候被实例化,它是全局唯一的,可以简单地把它理解为 Webpack 实例;Compiler中包含的东西如下所示:

Compilation 对象包含了当前的模块资源、编译生成资源、变化的文件等。当 Webpack 以开发模式运行时,每当检测到一个文件变化,一次新的 Compilation 将被创建。Compilation 对象也提供了很多事件回调供插件做扩展。通过 Compilation 也能读取到 Compiler 对象。

好了,看到这里我相信你已经掌握了一个webpack插件的基本开发方式了。这个东西咋说呢,只有自己去多试试,多玩玩上手才能快,下面也会为大家演示一些稍微复杂一些的插件的开发案例。可以跟着一起来玩玩呀。

# fileList.md案例

唔...看了网上挺多这个fileList.md案例的,要不咱也给整一个?

# 明确需求

它的功能点其实很简单:

  • 在每次webpack打包之后,自动产生一个打包文件清单,实际上就是一个markdown文件,上面记录了打包之后的文件夹dist里所有的文件的一些信息。

大家在接收到这个需求的时候,可以先想想要如何去实现:

  • 首先要确定我们的插件是不是需要传递参数进去
  • 确定我们的插件是要在那个钩子函数中执行
  • 我们如何创建一个markdown文件并塞到dist
  • markdown文件内的内容是长什么样的

针对第一点,我认为我们可以传递一个最终生成的文件名进去,例如这样调用:

module.exports = {
  new FileListPlugin({
    filename: 'fileList.md'
  })
}

第二点,因为是在打包完成之前,所以我们可以去compiler 钩子来查查有没有什么可以用的。

咦~这个叫做emit的好像挺符合的:

  • 类型: AsyncSeriesHook
  • 触发的事件:生成资源到 output 目录之前。
  • 参数:compilation

第三点的话,难道要弄个nodefs?再创建个文件之类的?唔...不用搞的那么复杂,等会让我们看个简单点的方式。

第四点,我们就简单点,例如写入这样的内容就可以了:

# 一共有2个文件

- main.bundle.js
- index.html

# 代码分析

由于功能也并不算很复杂,这里就直接上代码了,然后再来一步一步解析。

还是基于刚刚的案例,让我们继续在plugins文件夹下创建一个新的插件:

plugins/File-list-plugin.js:

function FileListPlugin (options) {
  this.options = options || {};
  this.filename = this.options.filename || 'fileList.md'
}

FileListPlugin.prototype.apply = function (compiler) {
  // 1.
  compiler.hooks.emit.tapAsync('FileListPlugin', (compilation, cb) => {
    // 2.
    const fileListName = this.filename;
    // 3.
    let len = Object.keys(compilation.assets).length;
    // 4.
    let content = `# 一共有${len}个文件\n\n`;
    // 5.
    for (let filename in compilation.assets) {
      content += `- ${filename}\n`
    }
    // 6.
    compilation.assets[fileListName] = {
      // 7.
      source: function () {
        return content;
      },
      // 8.
      size: function () {
        return content.length;
      }
    }
    // 9.
    cb();
  })
}
module.exports = FileListPlugin;

代码分析:

  1. 通过compiler.hooks.emit.tapAsync()来触发生成资源到output目录之前的钩子,且回调函数会有两个参数,一个是compilation,一个是cb回调函数
  2. 要生成的markdown文件的名称
  3. 通过compilation.assets获取到所有待生成的文件,这里是获取它的长度
  4. 定义markdown文件的内容,也就是先定义一个一级标题,\n表示的是换行符
  5. 将每一项文件的名称写入markdown文件内
  6. 给我们即将生成的dist文件夹里添加一个新的资源,资源的名称就是fileListName变量
  7. 写入资源的内容
  8. 指定新资源的大小,用于webpack展示
  9. 由于我们使用的是tapAsync异步调用,所以必须执行一个回调函数cb,否则打包后就只会创建一个空的dist文件夹。

好滴,大功告成,让我们赶紧来试试这个新插件吧,修改webpack.config.js的配置:

webpack.config.js:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
// const No1WebpackPlugin = require('./plugins/No1-webpack-plugin');
// const No2WebpackPlugin = require('./plugins/No2-webpack-plugin');
const FileListPlugin = require('./plugins/File-list-plugin');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: '[name].bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    }),
    new CleanWebpackPlugin(),
    // new No1WebpackPlugin({ msg: 'good boy!' })
    // new No2WebpackPlugin({ msg: 'bad boy!' })
    new  FileListPlugin()
  ]
}

来执行一下npm run build看看吧:

# 使用tapPromise重写

可以看到,上面👆的案例我们是使用tapAsync来调用钩子函数,这个tapPromise好像还没有玩过,唔...我们看看它是怎样用的。

现在让我们来改下需求,刚刚我们好像看不太出来是异步执行的。现在我们改为1s后才输出资源。

重写一下刚刚的插件:

plugins/File-list-plugin.js:

function FileListPlugin (options) {
  this.options = options || {};
  this.filename = this.options.filename || 'fileList.md'
}

FileListPlugin.prototype.apply = function (compiler) {
  // 第二种 Promise
  compiler.hooks.emit.tapPromise('FileListPlugin', compilation => {
    return new Promise(resolve => {
      setTimeout(() => {
        resolve()
      }, 1000)
    }).then(() => {
      const fileListName = this.filename;
      let len = Object.keys(compilation.assets).length;
      let content = `# 一共有${len}个文件\n\n`;
      for (let filename in compilation.assets) {
        content += `- ${filename}\n`;
      }
      compilation.assets[fileListName] = {
        source: function () {
          return content;
        },
        size: function () {
          return content.length;
        }
      }
    })
  })
}
module.exports = FileListPlugin;

可以看到它与第一种tapAsync写法的区别了:

  • 回调函数中只需要一个参数compilation,不需要再调用一下cb()
  • 返回的是一个Promise,这个Promise1s后才resolve()

大家可以自己写写看看效果,应该是和我们预期的一样的。

另外,tapPromise还允许我们使用async/await的方式,比如这样:

function FileListPlugin (options) {
  this.options = options || {};
  this.filename = this.options.filename || 'fileList.md'
}

FileListPlugin.prototype.apply = function (compiler) {
  // 第三种 await/async
  compiler.hooks.emit.tapPromise('FileListPlugin', async (compilation) => {
    await new Promise(resolve => {
      setTimeout(() => {
        resolve()
      }, 1000)
    })
    const fileListName = this.filename;
    let len = Object.keys(compilation.assets).length;
    let content = `# 一共有${len}个文件\n\n`;
    for (let filename in compilation.assets) {
      content += `- ${filename}\n`;
    }
    compilation.assets[fileListName] = {
      source: function () {
        return content;
      },
      size: function () {
        return content.length;
      }
    }
  })
}
module.exports = FileListPlugin;

# Watch-plugin案例

# 明确需求

话不多说,让我们接着来看一个监听的案例。需求如下:

  • 当项目在开启观察者watch模式的时候,监听每一次资源的改动
  • 当每次资源变动了,将改动资源的个数以及改动资源的列表输出到控制台中
  • 监听结束之后,在控制台输出"本次监听停止了哟~"

那么首先为了满足第一个条件,我们得设计一条watch的指令,以保证使用npm run watch命令之后,会看到编译过程,但是不会退出命令行,而是实时监控文件。这也很简单,加一条脚本命令就可以了。

package.json:

{
  "script": "webpack --watch --mode development"
}

然后想一想我们的插件该如何设计,这时候就要知道我们需要调用哪个钩子函数了。

去官网上看一看,这个watchRun就很符合呀:

  • 类型:AsyncSeriesHook
  • 触发的事件:监听模式下,一个新的编译(compilation)触发之后,执行一个插件,但是是在实际编译开始之前。
  • 参数:compiler

针对第三点,监听结束之后,watchClose就可以了:

  • 类型:SyncHook
  • 触发的事件:监听模式停止。
  • 参数:无

# 代码分析

好的👌,让我们开干吧。在此项目的plugins文件夹下再新建一个叫做Watch-plugin的插件。

先搭一下插件的架子吧:

plugins/Watch-plugin.js:

function WatcherPlugin (options) {
  this.options = options || {};
}

WatcherPlugin.prototype.apply = function (compiler) {
  compiler.hooks.watchRun.tapAsync('WatcherPlugin', (compiler, cb) => {
    console.log('我可是时刻监听着的 🚀🚀🚀')
    console.log(compiler)
    cb()
  })
  compiler.hooks.watchClose.tap('WatcherPlugin', () => {
    console.log('本次监听停止了哟~👋👋👋')
  })
}
module.exports = WatcherPlugin;

(额,这个火箭🚀是用Mac自带的输入法打出来的,其它输入法应该也有吧)

通过上面几个案例的讲解,这段代码大家应该都没有什么疑问了吧。

那么现在的问题就是如何知道哪些文件改变了。其实我们在研究一个新东西的时候,如果没啥思路,不如就在已有的条件上先找一下,比如这里我们就只知道一个compiler,那么我们就可以查找一下它里面的属性,看看有什么是我们能用的吗。

也就是上面的这张图:

可以看到,有一个叫做watchFileSystem的属性应该就是我们想要的监听文件的属性了,打印出来看看?

好滴👌,那就先让我启动这个插件吧,也就是改一下webpack.config.js那里的配置,由于上面几个案例都已经演示过了这里就不再累赘,直接跳过讲解这一步了。

直接让我们来npm run watch一下吧,控制台已经输出了它,可是由于我们是需要监听文件的改变,所以虽然控制台输出了watchFileSystem,但是这一次是初始化时打印的,也就是说我们需要改动一下本地的一个资源然后保存再来看看效果。

例如,我随便改动一下src/index.js中的内容然后保存。这时候就触发了监听事件了,让我们来看一下打印的结果:

可以看到watchFileSystem中确实有一个watch属性,而且里面有一个fileWatchers的列表,还有一个mtimes对象。这两个属性引起了我的注意。貌似mtimes对象就是我们想要的了。

它是一个键值对,键名为改动的文件的路径,值为时间。

那么我们就可以直接来获取它了:

function WatcherPlugin (options) {
  this.options = options || {};
}

WatcherPlugin.prototype.apply = function (compiler) {
  compiler.hooks.watchRun.tapAsync('WatcherPlugin', (compiler, cb) => {
    console.log('我可是时刻监听着的 🚀🚀🚀')
    let mtimes = compiler.watchFileSystem.watcher.mtimes;
    let mtimesKeys = Object.keys(mtimes);
    if (mtimesKeys.length > 0) {
      console.log(`本次一共改动了${mtimesKeys.length}个文件,目录为:`)
      console.log(mtimesKeys)
      console.log('------------分割线-------------')
    }
    cb()
  })
  compiler.hooks.watchClose.tap('WatcherPlugin', () => {
    console.log('本次监听停止了哟~👋👋👋')
  })
}
module.exports = WatcherPlugin;

好滴,接着:

  • 保存文件
  • 重新执行npm run watch
  • 第一次打印看不出效果,接着让我们改动一下src/index.js,随便加个注释
  • 再保存src/index.js文件,打印结果如下:

好滴👌,这样就实现了一个简单的文件监听功能。不过使用mtimes只能获取到简单的文件的路径和修改时间。如果要获取更加详细的信息可以使用compiler.watchFileSystem.watcher.fileWatchers,但是我试了一下这里面的数组是会把node_modules里的改变也算上的,例如这样:

所以如果针对于这道题的话,我们可以写一个正则小小的判断一下,去除node_modules文件夹里的改变,代码如下:

function WatcherPlugin (options) {
  this.options = options || {};
}

WatcherPlugin.prototype.apply = function (compiler) {
  compiler.hooks.watchRun.tapAsync('WatcherPlugin', (compiler, cb) => {
    console.log('我可是时刻监听着的 🚀🚀🚀')
    // let mtimes = compiler.watchFileSystem.watcher.mtimes;
    // let mtimesKeys = Object.keys(mtimes);
    // if (mtimesKeys.length > 0) {
    //   console.log(`本次一共改动了${mtimesKeys.length}个文件,目录为:`)
    //   console.log(mtimesKeys)
    //   console.log('------------分割线-------------')
    // }
    const fileWatchers = compiler.watchFileSystem.watcher.fileWatchers;
    console.log(fileWatchers)
    let paths = fileWatchers.map(watcher => watcher.path).filter(path => !/(node_modules)/.test(path))
    
    if (paths.length > 0) {
      console.log(`本次一共改动了${paths.length}个文件,目录为:`)
      console.log(paths)
      console.log('------------分割线-------------')
    }
    cb()
  })
  compiler.hooks.watchClose.tap('WatcherPlugin', () => {
    console.log('本次监听停止了哟~👋👋👋')
  })
}
module.exports = WatcherPlugin;

另外在读 《深入浅出Webpack》的时候,里面也有提到:

默认情况下 Webpack 只会监视入口和其依赖的模块是否发生变化,在有些情况下项目可能需要引入新的文件,例如引入一个 HTML 文件。 由于 JavaScript 文件不会去导入 HTML 文件,Webpack 就不会监听 HTML 文件的变化,编辑 HTML 文件时就不会重新触发新的 Compilation。 为了监听 HTML 文件的变化,我们需要把 HTML 文件加入到依赖列表中,为此可以使用如下代码:

compiler.plugin('after-compile', (compilation, callback) => {
  // 把 HTML 文件添加到文件依赖列表,好让 Webpack 去监听 HTML 模块文件,在 HTML 模版文件发生变化时重新启动一次编译
    compilation.fileDependencies.push(filePath);
    callback();
})

感兴趣的小伙伴可以自己去实验一下,这里就不做演示了。

# Decide-html-plugin案例

再来看个案例,这个插件是用来检测我们有没有使用html-webpack-plugin插件的。

还记得我们前面说的Compiler对象中,包含了 Webpack 环境所有的的配置信息,包含 optionshookloadersplugins 这些信息。

那么这样我就可以通过plugins来判断是否使用了html-webpack-plugin了。

由于功能不复杂,这就直接上代码了:

function DecideHtmlPlugin () {}

DecideHtmlPlugin.prototype.apply = function (compiler) {
  compiler.hooks.afterPlugins.tap('DecideHtmlPlugin', compiler => {
    const plugins = compiler.options.plugins;
    const hasHtmlPlugin = plugins.some(plugin => {
      return plugin.__proto__.constructor.name === 'HtmlWebpackPlugin'
    })
    if (hasHtmlPlugin) {
      console.log('使用了html-webpack-plugin')
    }
  })
}

module.exports = DecideHtmlPlugin

有需要注意的点⚠️:

  • afterPlugins:设置完初始插件之后,执行插件。
  • plugins拿到的会是一个插件列表,包括我们的自定义插件DecideHtmlPlugin也会在里面
  • some()Array.prototype上的方法,用于判断某个数组是否有符合条件的项,只要有一项满足就返回true,否则返回false

配置一下webpack.config.js,来看看效果是可以的:

# Clean-plugin案例

还记得上面👆的项目我们用到的那个clean-webpack-plugin,现在我们自己来实现一个简易版的clean-webpack-plugin吧,名称就叫Clean-plugin

# 明确需求

一样的,首先还是明确一下我们的需求:

我们需要设计这么一个插件,在每次重新编译之后,都会自动清理掉上一次残余的dist文件夹中的内容,不过需要满足以下需求:

  • 插件的options中有一个属性为exclude,为一个数组,用来定义不需要清除的文件列表
  • 每次打包如果文件有修改则会生成新的文件且文件的指纹也会变(文件名以hash命名)
  • 生成了新的文件,则需要把以前的文件给清理掉。

例如我第一次打包之后,生成的dist目录结构是这样的:

/dist
  |- main.f89e7ffee29ee9dbf0de.js
  |- main.f97284d8479b13c49723.css

然后我修改了一下js文件并重新编译,新的目录结构应该是这样的:

/dist
  |- main.e0c6be8f72d73a68f73a.js
  |- main.f97284d8479b13c49723.css

可以看到,如果我们是用chunkhash给输出文件命名的话,只改变js文件,则js文件的文件名会发生变化,而不会影响css文件。

此时,我们就需要将旧的js文件给替换成新的,也就是只删除main.f89e7ffee29ee9dbf0de.js文件。

而如果我们在配置插件的时候加了exclude属性的话,则不需要把这个属性中的文件给删除。例如如果我是这样配置的话:

module.exports = {
  new CleanPlugin({
    exclude: [
      "main.f89e7ffee29ee9dbf0de.js"
    ]
  })
}

那么这时候就算你修改了js文件,结果虽然会生成新的js文件,但是也不会把旧的给删除,而是共存:

/dist
  |- main.f89e7ffee29ee9dbf0de.js
  |- main.e0c6be8f72d73a68f73a.js
  |- main.f97284d8479b13c49723.css

# 代码分析

所以针对于上面这个需求,我们先给自己几个灵魂拷问:

  1. 此插件在哪个钩子函数中执行
  2. 如何获取旧的dist文件夹中的所有文件
  3. 如何获取新生成的所有文件,以及options.exclude中的文件名称,并合并为一个无重复项的数组
  4. 如何将旧的所有文件和新的所有文件做一个对比得出需要删除的文件列表
  5. 如何删除被废弃的文件

(在这个过程中我们肯定会碰到很多自己不知道的知识点,请不要慌,大家都是有这么一个不会到会的过程)

问题一

在哪个钩子函数中执行,我觉得可以在"done"中,因为我们其中的一个目的就是既能拿到旧的文件夹内容,又能拿到新的。而在这个阶段,表示已经编译完成了,所以是可以拿到最新的资源了。

问题二

获取旧的dist文件夹内的内容。还记得我们的dist文件夹是怎么来的吗?它是在我们webpack.config.js这个文件中配置的output项:

module.exports = {
  output: {
    path: path.resolve(__dirname, 'dist')
  }
}

所以很轻松的我们可以通过compiler.options.output.path就拿到这个旧的输出路径了,然后我们需要去读取这个路径文件夹下的所有文件,也就是遍历dist文件夹。

这边我们需要用到一个叫recursive-readdir-sync的东西,稍后我们需要安装它,它的作用就是以递归方式同步读取目录路径的内容。(github地址为:https://github.com/battlejj/recursive-readdir-sync)

问题三

获取新生成的所有文件,也就是所有的资源。这点得看"done"回调函数中的参数stats了。如果你把这个参数打印出来看的话会发现它包括了webpack中的很多配置,包括options包括assets等等。而这里我们就是需要获取打包完之后的所有最新资源也就是assets属性。

你以为直接stats.assets获取就完了吗?如果你试图这样去做的话,就会报错了。在webpack中它鼓励你用stats.toJson().assets的方式来获取。这也不是很清楚原因,大家可以看一下这里:

https://www.codota.com/code/javascript/functions/webpack/Stats/toJson

然后至于options.exclude中的文件名称,这个在插件的构造函数中定义一个options属性就可以拿到了。

合并无重复项我们可以使用lodash.union方法,lodash它是一个高性能的 JavaScript 实用工具库,里面提供了许多的方法来使我们更方便的操作数组、对象、字符串等。而这里的union方法就是能把多个数组合并成一个无重复项的数组,例如🌰:

_.union([2], [1, 2]);
// => [2, 1]

至于为什么要把这两个数组组合起来呢?那也是为了保证exclude中定义的文件在后面比较的过程中不会被删除。

问题四

将新旧文件列表做对比,得出最终需要删除的文件列表。

唔...其实最难的点应该就是在这里了。因为这里并不是简单的文件名称字符串匹配,它需要涉及到路径问题。

例如,我们前面说到可以通过compiler.options.output.path拿到文件的输出路径,也就是dist的绝对路径,我们命名为outputPath,它可能是长这样的:

/Users/lindaidai/codes/webpack/webpack-example/webpack-custom-plugin/dist

而后我们会用一个叫recursive-readdir-sync的东西去处理这个绝对路径,获取里面的所有文件:

recursiveReadSync(outputPath)

这里得到的会是各个文件:

[
  file /Users/lindaidai/codes/webpack/webpack-example/webpack-custom-plugin/dist/main.f89e7ffee29ee9dbf0de.js,
  file /Users/lindaidai/codes/webpack/webpack-example/webpack-custom-plugin/dist/css/main.124248e814cc2eeb1fd4.css
]

以上得到的列表就是旧的dist文件夹中的所有文件列表。

而后,我们需要得到新生成的文件的列表,也就是stats.toJson().assets.map(file => file.name)exclude合并后的那个文件列表,我们称为newAssets。但是这里需要注意的就是newAssets中的是各个新生成的文件的名称,也就是这样:

[
  "main.e0c6be8f72d73a68f73a.js",
  "main.124248e814cc2eeb1fd4.css"
]

所以我们需要做一些额外的路径转换的处理,再来进行比较。

而如果在路径前缀相同的情况下,我们只需要把recursiveReadSync(outputPath)处理之后的结果做一层过滤,排除掉newAssets里的内容,那么留下来的就是需要删除的文件,也就是unmatchFiles这个数组。

有点绕?让我们来写下伪代码:

const unmatchFiles = recursiveReadSync(outputPath).filter(file => {
  // 这里与 newAssets 做对比
  // 过滤掉存在 newAssets 中的文件
})

// unmatchFiles 就是为我们需要清理的所有文件

在这个匹配的过程中,我们会需要用到一个minimatch的工具库,它很适合用来做这种文件路径的匹配。

github地址可以看这里:https://github.com/isaacs/minimatch

问题五

在上一步中我们会得到需要删除的文件列表,这时候只需要调用一下fs模块中的unlinkSync方法就可以删除了。

例如:

// 删除未匹配文件
unmatchFiles.forEach(fs.unlinkSync);

# 案例准备

好滴,分析了这么多,是时候动手来写一写了,还是基于之前的那个案例。让我们先来安装一下上面提到的一些模块或者工具:

cnpm i --save-dev recursive-readdir-sync minimatch lodash.union

唔。然后为了能看到之后修改文件有没有删除掉旧的文件这个效果,我们可以来写一些css的样式,然后用MiniCssExtractPlugin这个插件去提取出css代码,这样打包之后就可以放到一个单独的css文件中了。

关于这个插件,不清楚的小伙伴你就理解它为下面这个场景:

我的src下有一个index.js和一个style.css,如果在index.js中引用了style.css的话:

import './style.css';

最终的css代码是会被打包进js文件中的,webpack并不会那么智能的把它拆成一个单独的css文件。

所以这时候就可以用MiniCssExtractPlugin这个插件来单独的提前css。(不过这个插件的主要作用还是为了提取公共的css代码哈,在这里我们只是为了将css提取出来)

好滴,首先让我们来安装它,顺便安装一下另两个loader

cnpm i --save-dev style-loader css-loader mini-css-extract-plugin

然后在src目录下新建一个style.css文件,并写点样式:

src/style.css:

.color_red {
  color: red;
}
.color_blue {
  color: blue;
}

接着快速来配置一下webpack.config.js:

(这里面有用到一个CleanPlugin的插件,它是我们接下来要创建的文件)

webpack.config.js:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const CleanPlugin = require('./plugins/Clean-plugin');
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
  entry: [
    './src/index.js',
    './src/style.css'
  ],
  output: {
    filename: '[name].[contenthash].js',
    path: path.resolve(__dirname, 'dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'custom-plugin'
    }),
    new CleanPlugin(),
    new MiniCssExtractPlugin({
      filename: 'css/[name].[contenthash].css'
    })
  ],
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [MiniCssExtractPlugin.loader, 'css-loader']
      }
    ]
  }
}

这里有一点前面也提到了,就是关于output.filename的命名和MiniCssExtractPlugin中生成css文件的命名,我们采用contenthash的方式,这样的话,如果我们只改变了js文件的话,那么重新打包之后,就只有js文件的hash会被重新生成,而css不会。这也是为了之后看到效果。

# coding

最后,在plugins文件夹下创建我们的Clean-plugin.js吧:

plugins/Clean-plugin.js:

const recursiveReadSync = require("recursive-readdir-sync");
const minimatch = require("minimatch");
const path = require("path");
const fs = require("fs");
const union = require("lodash.union");
function CleanPlugin (options) {
  this.options = options;
}
// 匹配文件
function getUnmatchFiles(fromPath, exclude = []) {
  const unmatchFiles = recursiveReadSync(fromPath).filter(file =>
    exclude.every(
      excluded => {
        return !minimatch(path.relative(fromPath, file), path.join(excluded), {
          dot: true
        })
      }
    )
  );
  return unmatchFiles;
}
CleanPlugin.prototype.apply = function (compiler) {
  const outputPath = compiler.options.output.path;
  compiler.hooks.done.tap('CleanPlugin', stats => {
    if (compiler.outputFileSystem.constructor.name !== "NodeOutputFileSystem") {
      return;
    }
    const assets = stats.toJson().assets.map(asset => asset.name);
    // 多数组合并并且去重
    const newAssets = union(this.options.exclude, assets);
    // 获取未匹配文件
    const unmatchFiles = getUnmatchFiles(outputPath, newAssets);
    // 删除未匹配文件
    unmatchFiles.forEach(fs.unlinkSync);
  })
}

module.exports = CleanPlugin;

比较难的技术难点在「代码分析」中都已经说明了,这里主要说下:

path.relative()

path.relative() 方法根据当前工作目录返回 fromto 的相对路径。 如果 fromto 各自解析到相同的路径(分别调用 path.resolve() 之后),则返回零长度的字符串。

path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb');
// 返回: '../../impl/bbb'

# 试试效果

先来看看我们现在的目录结构:

首先执行一遍npm run build,生成如下内容:

然后修改一下src/index.js中的内容,例如添加一行代码,之后再重新执行npm run build

可以看到,只有改变的index.js被重新删除替换了,而css文件没有。

再来验证一下options.exclude,在webpack.config.js中添加一个插件的参数,就用上一次生成的js的名称吧:

module.exports = {
  plugins: [
    new CleanPlugin({
      exclude: [
        "main.e0c6be8f72d73a68f73a.js"
      ]
    }),
  ]
}

再去修改一下index.js的内容,例如加两个注释,然后执行npm run build,会发现这次旧的js文件并不会被删除,而是会在原来的基础上添加一个新的js文件。这也证明了我们的exclude属性是可用的:

阅读全文