前言
上文说道我们拿到了构建modlule的factory,和依赖等关键数据,通过addModuleTree经过factorizeQueue
的控制走到了factory.create
。这个时候就开始了reslove过程。
本文主要分析,NormalModuleFactory
内部 beforeResolve
,factorize
,resolve
, afterResolve
这几个钩子。
配置文件
本文围绕的配置文件如下:
module.exports = {
mode: 'production',
entry: './src/index.js',
output: {
filename: 'main.js',
path: path.resolve(__dirname, 'dist'),
},
module: {
rules: [
{
test: /\.(js?|tsx?|ts?)$/,
use: [
{
loader: 'babel-loader',
},
],
},
]
},
resolve: {
extensions: ['.js', '.ts'],
alias: {
demo: path.resolve(__dirname, 'src/second'),
},
},
};
factory.create
入口从factory.create
开始,这里的 factory
是之前 addModuleTree
获取到的 NormalModuleFactory
NormalModuleFactory
先触发了其内部的 beforeResolve
钩子,然后在回调里执行了 factorize
钩子函数。factorize
钩子内有又调用了resolve
。
这里看起来比较绕,简单解释一下:
钩子的调用顺序,就像是这样。beforeResolve
-> factorize
-> resolve
- beforeResolve 没找到之前注册过的地方,看起来什么都没干,也有可能是我没找到
- factorize 之前在
ExternalModuleFactoryPlugin
插件中注册过,这里会处理下external
的信息。 resolve
钩子注册在NormalModuleFactory
内部,用于解析这个module,生成对应的loader和依赖信息,这里的重点就在resolve
resolve
getLoaderResolver
进来的第一步resolve
钩子先调用了this.getResolver("loader")
返回loaderResolver,这个可以理解为是解析loader的方法。
简单过一下分为以下几步:
- 调用到了
ResolverFactory
里的get
方法 - 判断是否有对应类型的缓存
- 创建
resolveOptions
, - 调用
require("enhanced-resolve").ResolverFactory
创建了一个resolver
,然后返回NormalModuleFactory
继续执行代码。
const loaderResolver = this.getResolver("loader");
loaderResolver
暴露了一个resolver
方法,用于解析loader
。
normalResolver
接着往下走,略过一些判断,直接走到了defaultResolve
这个方法,这里会根据webpack配置文件中的resolve
选项,生成一个 normalResolver
。同样的,这个normalResolver
也是require("enhanced-resolve").ResolverFactory
的实例,也暴露出了一个resolve
方法。
const normalResolver = this.getResolver(
"normal",
dependencyType
? cachedSetProperty(
resolveOptions || EMPTY_RESOLVE_OPTIONS,
"dependencyType",
dependencyType
)
: resolveOptions
);
接下来会把这个normalResolver
和一些上下文信息传给resolveResource
方法,这里最终会调用到node_modules/enhanced-resolve/lib/Resolver.js
的doResolve
。
this.resolveResource(
contextInfo,
context,
unresolvedResource,
normalResolver,
resolveContext,
(err, resolvedResource, resolvedResourceResolveData) => {
if (err) return continueCallback(err);
if (resolvedResource !== false) {
resourceData = {
resource: resolvedResource,
data: resolvedResourceResolveData,
...cacheParseResource(resolvedResource)
};
}
continueCallback();
}
);
然后根据doResolve
返回的resolvedResource
和resolvedResourceResolveData
一起拼装成resourceData
。我们在后续解析loader的时候还会用到这个。
解析loader
在resolvedResource
的回调里继续执行
const result = this.ruleSet.exec({
resource: resourceDataForRules.path,
realResource: resourceData.path,
resourceQuery: resourceDataForRules.query,
resourceFragment: resourceDataForRules.fragment,
scheme,
assertions,
mimetype: matchResourceData
? ""
: resourceData.data.mimetype || "",
dependency: dependencyType,
descriptionData: matchResourceData
? undefined
: resourceData.data.descriptionFileData,
issuer: contextInfo.issuer,
compiler: contextInfo.compiler,
issuerLayer: contextInfo.issuerLayer || ""
});
这里会根据配置文件里的rules
得到需要的loader,这个例子里,我们的result
是
接下来会通过这个result
的遍历,生成useLoadersPost
, useLoaders
, useLoadersPre
。
然后调用resolveRequestArray
得到postLoaders, normalLoaders, preLoaders
。
this.resolveRequestArray(
contextInfo,
this.context,
useLoaders,
loaderResolver,
resolveContext,
(err, result) => {
normalLoaders = result;
continueCallback(err);
}
);
当前例子并没有postLoaders
和preLoaders
,这里只有normalLoaders
。resolveRequestArray
内部调用loaderResolver.resolve
解析useLoaders
,最后结果就是把result
里的loader替换成了对应的真实文件地址。
{
ident:undefined
loader:'/Users/csy/Code/webpack5/node_modules/babel-loader/lib/index.js'
options:undefined
}
生成回调数据
最后在continueCallback
处理下已经生成好的数据,首先是对loader
的合并。把postLoaders, normalLoaders, preLoaders
这几个合并。然后assign
一下data.createData
, 这个data
来自于钩子的入口传入的data。
Object.assign(data.createData, {
layer:
layer === undefined ? contextInfo.issuerLayer || null : layer,
request: stringifyLoadersAndResource(
allLoaders,
resourceData.resource
),
userRequest,
rawRequest: request,
loaders: allLoaders,
resource: resourceData.resource,
context:
resourceData.context || getContext(resourceData.resource),
matchResource: matchResourceData
? matchResourceData.resource
: undefined,
resourceResolveData: resourceData.data,
settings,
type,
parser: this.getParser(type, settings.parser),
parserOptions: settings.parser,
generator: this.getGenerator(type, settings.generator),
generatorOptions: settings.generator,
resolveOptions
});
这里着重讲一下getParser
和getGenerator
, 这两个方法返回的是对应文件的解析器和构建模板的方法。按照当前示例,返回的是JavascriptParser
和JavascriptGenerator
。
然后这个createData
将被用于createModule
。
在执行完NormalModuleFactory
的afterResolve
钩子后
const createData = resolveData.createData;
this.hooks.createModule.callAsync(//something)
reslove结束了,即将开始下一步,创建module
!
小结
- module resolve 流程用于获得各 loader 和模块的绝对路径等信息。
- 在
resolver
钩子里,先通过 enhanced-resolve 获取loaderResolver
,提供 resolve 方法 - 在
defaultResolve
方法里,获取normalResolver
, 提供 resolve 方法。 - 解析
unresolvedResource
,得到文件的绝对路径等信息 - 根据
rules
得到 loader - 使用
loaderResolver
得到loader的绝对路径等信息 - 合并 loader, 拼接数据,
- 调用
NormalModuleFactory
的afterResolve
钩子,结束resolve
流程。