compiler 钩子

Compiler 模块是 webpack 的支柱引擎，它通过 CLI 或 Node API 传递的所有选项，创建出一个 compilation 实例。它扩展(extend)自 Tapable 类，以便注册和调用插件。大多数面向用户的插件首，会先在 Compiler 上注册。

T> 此模块会暴露在 webpack.Compiler，可以直接通过这种方式使用。关于更多信息，请查看这个示例。

监听(watching)

Compiler 支持可以监控文件系统的监听(watching)机制，并且在文件修改时重新编译。当处于监听模式(watch mode)时，compiler 会触发诸如 watchRun, watchClose 和 invalid 等额外的事件。通常用于开发环境中使用，也常常会在 webpack-dev-server 这些工具的底层之下调用，由此开发人员无须每次都使用手动方式重新编译。还可以通过 CLI 进入监听模式。

相关钩子

以下生命周期钩子函数，是由 compiler 暴露，可以通过如下方式访问：

compiler.hooks.someHook.tap(...)

取决于不同的钩子类型，也可以在某些钩子上访问 tapAsync 和 tapPromise。

`entryOption`

SyncBailHook

在 entry 配置项处理过之后，执行插件。

`afterPlugins`

SyncHook

设置完初始插件之后，执行插件。

参数：compiler

`afterResolvers`

SyncHook

resolver 安装完成之后，执行插件。

参数：compiler

`environment`

SyncHook

environment 准备好之后，执行插件。

`afterEnvironment`

SyncHook

environment 安装完成之后，执行插件。

`beforeRun`

AsyncSeriesHook

compiler.run() 执行之前，添加一个钩子。

参数：compiler

`run`

AsyncSeriesHook

开始读取 records 之前，钩入(hook into) compiler。

参数：compiler

`watchRun`

AsyncSeriesHook

监听模式下，一个新的编译(compilation)触发之后，执行一个插件，但是是在实际编译开始之前。

参数：compiler

`normalModuleFactory`

SyncHook

NormalModuleFactory 创建之后，执行插件。

参数：normalModuleFactory

`contextModuleFactory`

ContextModuleFactory 创建之后，执行插件。

参数：contextModuleFactory

`beforeCompile`

AsyncSeriesHook

编译(compilation)参数创建之后，执行插件。

参数：compilationParams

`compile`

SyncHook

一个新的编译(compilation)创建之后，钩入(hook into) compiler。

参数：compilationParams

`thisCompilation`

SyncHook

触发 compilation 事件之前执行（查看下面的 compilation）。

参数：compilation

`compilation`

SyncHook

编译(compilation)创建之后，执行插件。

参数：compilation

`make`

AsyncParallelHook

...

参数：compilation

`afterCompile`

AsyncSeriesHook

...

参数：compilation

`shouldEmit`

SyncBailHook

此时返回 true/false。

参数：compilation

`needAdditionalPass`

SyncBailHook

...

`emit`

AsyncSeriesHook

生成资源到 output 目录之前。

参数：compilation

`afterEmit`

AsyncSeriesHook

生成资源到 output 目录之后。

参数：compilation

`done`

SyncHook

编译(compilation)完成。

参数：stats

`failed`

SyncHook

编译(compilation)失败。

参数：error

`invalid`

SyncHook

监听模式下，编译无效时。

参数：fileName, changeTime

`watchClose`

SyncHook

监听模式停止。