前言
上文說道我們拿到了構建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的時候還會用到這個。
resourceData
資料結構
解析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
流程。