您好,登錄后才能下訂單哦!
本文小編為大家詳細(xì)介紹“webpack核心概念之entry怎么配置”,內(nèi)容詳細(xì),步驟清晰,細(xì)節(jié)處理妥當(dāng),希望這篇“webpack核心概念之entry怎么配置”文章能幫助大家解決疑惑,下面跟著小編的思路慢慢深入,一起來學(xué)習(xí)新知識吧。
如果把工程中各個模塊的依賴關(guān)系當(dāng)作一棵樹,那么入口(entry)就是這棵依賴樹的根
這些存在依賴關(guān)系的模塊會在打包時被封裝為一個chunk。那chunk是什么呢?
chunk字面的意思是代碼塊,在Webpack中可以理解成被抽象和包裝過后的一些模塊。它就像一個裝著很多文件的文件袋,里面的文件就是各個模塊,Webpack在外面加了一層包裹,從而形成了chunk:
根據(jù)具體配置不同,一個工程打包時可能會產(chǎn)生一個或多個chunk。
工程中可以定義多個入口,每一個入口都會產(chǎn)生一個結(jié)果資源
比如我們工程中有兩個入口src/index.js
和src/lib.js
,在一般情形下會打包生成dist/index.js
和dist/lib.js
。
在一些特殊情況下,一個入口也可能產(chǎn)生多個chunk并最終生成多個bundle
參數(shù):Entry
entry 是配置模塊的入口,可抽象成輸入,Webpack 執(zhí)行構(gòu)建的第一步將從入口開始搜尋及遞歸解析出所有入口依賴的模塊
entry 配置是必填的,若不填則將導(dǎo)致 Webpack 報錯退出
module.exports = { entry:'./src/index.js', //表示入口文件,即從index.js進入我們的項目 };
①Entry 類型
類型 | 例子 | 含義 |
---|---|---|
string | ‘./app/entry’ | 入口模塊的文件路徑,可以是相對路徑 |
array | [’./app/entry1’, ‘./app/entry2’] | 入口模塊的文件路徑,可以是相對路徑 |
object | { a: ‘./app/entry-a’, b: [’./app/entry-b1’, ‘./app/entry-b2’]} | 配置多個入口,每個入口生成一個 Chunk |
如果是 array 類型,則搭配 output.library 配置項使用時,只有數(shù)組里的最后一個入口文件的模塊會被導(dǎo)出
②Chunk 名稱
Webpack 會為每個生成的 Chunk 取一個名稱,Chunk 的名稱和 Entry 的配置有關(guān):
如果 entry 是一個 string 或 array ,就只會生成一個 Chunk,這時 Chunk 的名稱是 main ;
如果 entry 是一個 object ,就可能會出現(xiàn)多個 Chunk,這時 Chunk 的名稱是 object 鍵值對里鍵的名稱
③Entry 配置動態(tài)
假如項目里有多個頁面需要為每個頁面的入口配置一個 Entry ,但這些頁面的數(shù)量可能會不斷增長,則這時 Entry 的配置會受到到其他因素的影響導(dǎo)致不能寫成靜態(tài)的值。其解決方法是把 Entry 設(shè)置成一個函數(shù)去動態(tài)返回上面所說的配置,代碼如下:
// 同步函數(shù) entry: () => { return { a:'./pages/a', b:'./pages/b', } }; // 異步函數(shù) entry: () => { return new Promise((resolve)=>{ resolve({ a:'./pages/a', b:'./pages/b', }); }); };
參數(shù):context
Webpack 在尋找相對路徑的文件時會以 context 為根目錄,context 默認(rèn)為執(zhí)行啟動 Webpack 時所在的當(dāng)前工作目錄。 如果想改變 context 的默認(rèn)配置,則可以在配置文件里這樣設(shè)置它:
module.exports = { context: path.resolve(__dirname, 'app') }
注意, context 必須是一個絕對路徑的字符串。 除此之外,還可以通過在啟動 Webpack 時帶上參數(shù) webpack --context 來設(shè)置 context
用法:entry:string|Array<string>
1、簡寫語法
webpack.config.js
//由于是單個,所以可以簡寫成: module.exports = { entry: './main.js' };
上面的入口配置寫法其實是下面的簡寫
module.exports = { entry: { main: './main.js' } };
2、數(shù)組語法
module.exports = { entry: { main:['./main.js','./main2.js'] } };
傳入一個數(shù)組的作用是將多個資源預(yù)先合并,在打包時Webpack會將數(shù)組中的最后一個元素作為實際的入口路徑
在使用字符串或數(shù)組定義單入口時,并沒有辦法更改chunk name,只能為默認(rèn)的“main”。
用法:entry: {[entryChunkName: string]: string|Array}
對象語法
module.exports = { entry: { app: './src/app.js', vendors: './src/vendors.js' } };
這會比較繁瑣。然而這是應(yīng)用程序中定義入口的最可擴展的方式。
“可擴展的 webpack 配置”:可重用并且可以與其他配置組合使用。這是一種流行的技術(shù),用于將關(guān)注點從環(huán)境(environment)、構(gòu)建目標(biāo)(build target)、運行時(runtime)中分離。然后使用專門的工具(如 webpack-merge)將它們合并。
1、單頁應(yīng)用
無論是框架、庫,還是各個頁面的模塊,都由app.js
單一的入口進行引用。這樣做的好處是只會產(chǎn)生一個JS文件,依賴關(guān)系清晰。
module.exports = { entry: './src/app.js' };
這種做法也有弊端,即所有模塊都打包到一起,當(dāng)應(yīng)用的規(guī)模上升到一定程度之后會導(dǎo)致產(chǎn)生的資源體積過大,降低用戶的頁面渲染速度
在Webpack默認(rèn)配置中,當(dāng)一個bundle大于250kB時(壓縮前)會認(rèn)為這個bundle已經(jīng)過大了,在打包時會發(fā)生警告,如圖:
2、分離第三方庫(vendor)
為解決上方的問題,可以提取第三方庫(vender)
vendor的意思是“供應(yīng)商”,在Webpack中vendor一般指的是工程所使用的庫、框架等第三方模塊集中打包而產(chǎn)生的bundle
module.exports = { entry: { app: './src/app.js', vendors: ['react','react-dom','react-router'], } };
基于但也應(yīng)用的例子,我們添加了一個新的chunk name為vendor
的入口,并通過數(shù)組的形式把工程所依賴的第三方模塊放了進去
我們并沒有為vendor設(shè)置入口路徑,Webpack要如何打包呢?
這時我們可以使用CommonsChunkPlugin(在Webpack 4之后CommonsChunkPlugin已被廢棄,可以采用optimization.splitChunks)將app與vendor這兩個chunk中的公共模塊提取出來
通過這樣的配置,app.js產(chǎn)生的bundle將只包含業(yè)務(wù)模塊,其依賴的第三方模塊將會被抽取出來生成一個新的bundle,這也就達到了我們提取vendor的目標(biāo)
由于vendor僅僅包含第三方模塊,這部分不會經(jīng)常變動。因此可以有效地利用客戶端緩存,在用戶后續(xù)請求頁面時會加快整體的渲染速度。
CommonsChunkPlugin主要是用來提取第三方庫和公共模塊,避免首屏加載的bundle文件或者按需加載的bundle文件體積過大,從而導(dǎo)致加載時間過長。
3、多頁應(yīng)用
對于多頁應(yīng)用的場景,為了盡可能減小資源的體積,我們希望每個頁面都只加載各自必要的邏輯,而不是將所有頁面打包到同一個bundle中。因此每個頁面都需要有一個獨立的bundle,這種情形我們使用多入口來實現(xiàn)。請看下面的例子:
module.exports = { entry: { pageOne: './src/pageOne/index.js', pageTwo: './src/pageTwo/index.js', pageThree: './src/pageThree/index.js' } };
上面的配置告訴webpack 需要 3 個獨立分離的依賴圖,此時入口與頁面是一一對應(yīng)的,這樣每個HTML只要引入各自的JS就可以加載其所需要的模塊。
讀到這里,這篇“webpack核心概念之entry怎么配置”文章已經(jīng)介紹完畢,想要掌握這篇文章的知識點還需要大家自己動手實踐使用過才能領(lǐng)會,如果想了解更多相關(guān)內(nèi)容的文章,歡迎關(guān)注億速云行業(yè)資訊頻道。
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點不代表本網(wǎng)站立場,如果涉及侵權(quán)請聯(lián)系站長郵箱:is@yisu.com進行舉報,并提供相關(guān)證據(jù),一經(jīng)查實,將立刻刪除涉嫌侵權(quán)內(nèi)容。