在這一節(jié)使套,我們會討論 webpack 如何使用 require.ensure()
進行代碼拆分男娄。
require.ensure()
webpack 在編譯時震蒋,會靜態(tài)地解析代碼中的 require.ensure()
瞬场,同時將模塊添加到一個分開的 chunk 當中乾巧。這個新的 chunk 會被 webpack 通過 jsonp
來按需加載句喜。
語法如下:
require.ensure(dependencies: String[], callback: function(require), chunkName: String)
依賴 dependencies
這是一個字符串數(shù)組,通過這個參數(shù)沟于,在所有的回調函數(shù)的代碼被執(zhí)行前咳胃,我們可以將所有需要用到的模塊進行聲明。
回調 callback
當所有的依賴都加載完成后旷太,webpack會執(zhí)行這個回調函數(shù)拙绊。require
對象的一個實現(xiàn)會作為一個參數(shù)傳遞給這個回調函數(shù)。因此,我們可以進一步 require()
依賴和其它模塊提供下一步的執(zhí)行标沪。
chunk名稱 chunkName
chunkName 是提供給這個特定的 require.ensure()
的 chunk 的名稱榄攀。通過提供 require.ensure()
不同執(zhí)行點相同的名稱,我們可以保證所有的依賴都會一起放進相同的 文件束(bundle)金句。
讓我們來看以下的項目
\\ file structure
|
js --|
| |-- entry.js
| |-- a.js
| |-- b.js
webpack.config.js
|
dist
\\ entry.js
require('a');
require.ensure([], function(require){
require('b');
});
\\ a.js
console.log('***** I AM a *****');
\\ b.js
console.log('***** I AM b *****');
\\ webpack.config.js
var path = require('path');
module.exports = function(env) {
return {
entry: './js/entry.js',
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist')
}
}
}
通過執(zhí)行這個項目的 webpack 構建檩赢,我們發(fā)現(xiàn) webpack 創(chuàng)建了2個新的文件束, bundle.js
和 0.bundle.js
违寞。
entry.js
和 a.js
被打包進 bundle.js
.
b.js
被打包進 0.bundle.js
.
W> require.ensure
內部依賴于 Promises
贞瞒。 如果你在舊的瀏覽器中使用 require.ensure
請記得 去 shim Promise.
es6-promise polyfill.
require.ensure()
的坑點
空數(shù)組作為參數(shù)
require.ensure([], function(require){
require('./a.js');
});
以上代碼保證了拆分點被創(chuàng)建,而且 a.js
被 webpack 分開打包趁曼。
依賴作為參數(shù)
require.ensure(['./a.js'], function(require) {
require('./b.js');
});
上面代碼军浆, a.js
和 b.js
都被打包到一起,而且從主文件束中拆分出來挡闰。但只有 b.js
的內容被執(zhí)行乒融。a.js
的內容僅僅是可被使用,但并沒有被輸出摄悯。
想去執(zhí)行 a.js
赞季,我們需要異步地引用它,如 require('./a.js')
奢驯,讓它的 JavaScritp 被執(zhí)行申钩。