webpack4.x CommonJS模塊化淺析
先看下webpack官方文檔中對(duì)模塊的描述：
在模塊化編程中，開發(fā)者將程序分解成離散功能塊(discrete chunks of functionality)，并稱之為模塊。
每個(gè)模塊具有比完整程序更小的接觸面，使得校驗(yàn)、調(diào)試、測(cè)試輕而易舉。 精心編寫的模塊提供了可靠的抽象和封裝界限，使得應(yīng)用程序中每個(gè)模塊都具有條理清楚的設(shè)計(jì)和明確的目的。
webpack 的核心概念之一就是一切皆模塊，webpack 在項(xiàng)目中的作用就是，分析項(xiàng)目的結(jié)構(gòu)，找到 JavaScript 模塊以及其他一些瀏覽器不能直接運(yùn)行的拓展語言（less，scss，typescript），并將其打包為合適的格式以供瀏覽器使用，它從一個(gè)項(xiàng)目的主文件開始，根據(jù)引用路徑，找到所有其所依賴的文件，同時(shí)將這些文件進(jìn)行處理（各種loader來解析，編譯處理瀏覽器不能直接使用的文件），然后打包為一個(gè)或者多個(gè)瀏覽器可識(shí)別的JavaScript文件。
本文不會(huì)詳細(xì)描述 webpack 的構(gòu)建流程，畢竟官網(wǎng)已經(jīng)說得比較詳細(xì)了，這里主要是分析下 webpack 打包后的文件，將文件打包成什么樣子，又是如何使用模塊的。webpack 最早支持的代碼模塊化方式是 CommonJS，后面慢慢支持了 ES6、AMD 等，不論使用的是哪種方式，webpack 都可以對(duì)其進(jìn)行解析和打包，本文例子中使用的是 CommonJS 規(guī)范，更多規(guī)范介紹可查看官方文檔。
例子
為方便后面的說明，首先創(chuàng)建一個(gè)項(xiàng)目，也就是先建立一個(gè)文件夾 webpack-test（名字自擬），然后在里面新建一個(gè) package.json 文件，用來做 npm 的說明，在 webpack-test 文件夾中使用命令：
npm init
執(zhí)行命令后會(huì)詢問一些問題，一路回車即可。然后安裝下 webpack 的依賴包，如下命令：
npm install --save-dev webpack
再新建幾個(gè)文件：
1、在項(xiàng)目根目錄下新建文件夾 app 用來存放業(yè)務(wù)代碼、文件夾 public 存放打包后的文件；
2、在app中新建入口文件 main.js;
3、在app中新建功能模塊 hello.js，bye.js，to.js；
4、在項(xiàng)目根目錄下，建立 index.html 文件；
然后依次來給這幾個(gè)文件分別填寫以下內(nèi)容：
// webpack-test/app/hello.js
const to = require('./to.js');
module.exports = function() {
var hello = document.createElement('div');
hello.textContent = "Say Hello to " + to.name;
return hello;
};
// webpack-test/app/bye.js
const to = require('./to.js');
module.exports = function() {
var bye = document.createElement('div');
bye.textContent = "Say Bye to " + to.name;
return bye;
};
// webpack-test/app/to.js
module.exports = {name: "小明"};
// webpack-test/app/main.js
const hello = require('./hello.js');
const bye = require('./bye.js');
document.querySelector("#root").appendChild(hello()).appendChild(bye());;
// webpack-test/index.html <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Webpack Test Project</title> </head> <body> <div id='root'></div> // bundle.js 文件就是一會(huì)兒我們要打包app中的文件后生成的結(jié)果文件 <script src="public/bundle.js"></script> </body> </html>
業(yè)務(wù)模塊 hello.js 和 bye.js 做了各自的操作，同時(shí)引用了共同的文件 to.js；主文件 main.js 中引用并執(zhí)行了模塊 hello.js 和 bye.js；index.html 文件引入了 main.js 打包后的最終文件 bundle.js。
打包
接下來進(jìn)行打包操作，先確保 webpack 是全局安裝的，否則執(zhí)行時(shí)需要指定 webpack 的路徑，比如在 4.0 以下版本中使用 node_modules/.bin/webpack ./app/main.js ./public/bundle.js；
如果你使用的是 webpack4.0+ 的話，使用 webpack ./app/main.js ./public/bundle.js命令，也許會(huì)報(bào)以下的錯(cuò)誤：
WARNING in configuration
The 'mode' option has not been set, webpack will fallback to 'production' for this value. Set 'mode' option to 'development' or 'production' to enable defaults for each environment.
You can also set it to 'none' to disable any default behavior. Learn more: https://webpack.js.org/concepts/mode/ERROR in multi ./app/main.js ./public/bundle.js
Module not found: Error: Can't resolve './public/bundle.js' in '/Users/zhaohaipeng/soyoung-project/webpack-test'
@ multi ./app/main.js ./public/bundle.js main[1]
webpack4.0+之后，針對(duì)第一個(gè)報(bào)錯(cuò)，需要指定環(huán)境 --mode development；第二個(gè)報(bào)錯(cuò)，是因?yàn)槲覀儧]有使用配置文件的方式打包，而是直接使用的命令指定的打包輸出位置，所以需要聲明輸出文件，綜上，正確的命令如下：
webpack app/main.js --output public/bundle.js --mode development
執(zhí)行結(jié)果：
➜ webpack-test webpack app/main.js --output public/bundle.js --mode development
Hash: a4e2f9ecc51b64891624
Version: webpack 4.25.1
Time: 90ms
Built at: 2018-11-08 17:11:01
Asset Size Chunks Chunk Names
bundle.js 5.16 KiB main [emitted] main
Entrypoint main = bundle.js
[./app/bye.js] 165 bytes {main} [built]
[./app/hello.js] 173 bytes {main} [built]
[./app/main.js] 144 bytes {main} [built]
[./app/to.js] 30 bytes {main} [built]
➜ webpack-test
瀏覽器打開 index.html 文件，即可看到結(jié)果
Say Hello to 小明
Say Bye to 小明
但是 webpack 作為一個(gè)能簡化我們開發(fā)難度和使用便捷的工具，顯然像上面那樣通過敲很多命令來打包，并不方便，所以下面采用配置文件的方式再來一次：
根目錄創(chuàng)建 webpack.config.js 文件，并配置下打包入口和出口：
// webpack-test/webpack.config.js
module.exports = {
mode: "development",//webpack.0之后需要聲明環(huán)境
entry: __dirname + "/app/main.js",//唯一入口文件
output: {
path: __dirname + "/public",//打包后的文件存放目錄
filename: "bundle.js"http://打包后輸出文件名
}
}
再次打包的時(shí)候，只需要使用命令 webpack 就可以了，webpack 默認(rèn)讀取當(dāng)前路徑下的 webpack.config.js 文件。
最終打包好的 bundle.js 文件，去除了多余注釋，調(diào)整了代碼格式，內(nèi)容如下：
// 自執(zhí)行函數(shù)，參數(shù)為所有模塊組成的，形勢(shì)為key:value，key是模塊名
(function(modules) { // webpackBootstrap
// 已加載模塊的緩存，記錄模塊的加載情況，也是為了避免重復(fù)打包，節(jié)省資源
var installedModules = {};
// webpack 使用 require 方式加載模塊的方法（模擬ConmmonJS reqiure()），作用為根據(jù)傳進(jìn)來的模塊id來處理對(duì)應(yīng)的模塊，加入已加載緩存，執(zhí)行，標(biāo)記，返回exports
function __webpack_require__(moduleId) {
// moduleId 為模塊路徑
// 檢測(cè)模塊是否已加載，已加載的話直接返回該模塊
if(installedModules[moduleId]) {
return installedModules[moduleId].exports;
}
// 當(dāng)前模塊未加載的話，新建，并存于緩存
var module = installedModules[moduleId] = {
i: moduleId,
l: false,
exports: {}
};
// 在當(dāng)前模塊的 exports 下，也就是模塊的內(nèi)部執(zhí)行模塊代碼，突出作用域
modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
// 標(biāo)記模塊已經(jīng)加載
module.l = true;
// 返回模塊的導(dǎo)出內(nèi)容
return module.exports;
}
// 掛載屬性，該模塊 (__webpack_modules__)
__webpack_require__.m = modules;
// 掛載屬性，模塊加載緩存
__webpack_require__.c = installedModules;
// 本代碼中未執(zhí)行，暫時(shí)不分析
// 在 exports 中定義 getter 方法
__webpack_require__.d = function(exports, name, getter) {
// 當(dāng) name 屬性不是定義在對(duì)象本身，而是繼承自原型鏈，則在在 exports 中定義 getter 方法
if(!__webpack_require__.o(exports, name)) {
Object.defineProperty(exports, name, { enumerable: true, get: getter });
}
};
// 本代碼中未執(zhí)行，暫時(shí)不分析
// 在 exports 中定義 __esModule，定義key為Symbol的屬性（在__webpack_require__.t中被調(diào)用）
// define __esModule on exports
__webpack_require__.r = function(exports) {
if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
}
Object.defineProperty(exports, '__esModule', { value: true });
};
// 本代碼中未執(zhí)行，暫時(shí)不分析
// 創(chuàng)建一個(gè)偽命名空間的對(duì)象
// create a fake namespace object
// mode & 1: value is a module id, require it
// mode & 2: merge all properties of value into the ns
// mode & 4: return value when already ns object
// mode & 8|1: behave like require
__webpack_require__.t = function(value, mode) {
if(mode & 1) value = __webpack_require__(value);
if(mode & 8) return value;
if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
var ns = Object.create(null);
__webpack_require__.r(ns);
Object.defineProperty(ns, 'default', { enumerable: true, value: value });
if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));
return ns;
};
// 本代碼中未執(zhí)行，暫時(shí)不分析
// getDefaultExport function for compatibility with non-harmony modules
__webpack_require__.n = function(module) {
var getter = module && module.__esModule ?
function getDefault() { return module['default']; } :
function getModuleExports() { return module; };
__webpack_require__.d(getter, 'a', getter);
return getter;
};
// Object.prototype.hasOwnProperty.call
// 判斷一個(gè)屬性是定義在對(duì)象本身而不是繼承自原型鏈
__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
// __webpack_public_path__
__webpack_require__.p = "";
// 加載入口模塊 main.js ，返回 exports，從而從入口文件開始執(zhí)行，以遞歸的方式，將所有依賴執(zhí)行并返回
return __webpack_require__(__webpack_require__.s = "./app/main.js");
})({
"./app/bye.js": (function(module, exports, __webpack_require__) {
eval("const to = __webpack_require__(/*! ./to.js */ \"./app/to.js\");\nmodule.exports = function() {\n var bye = document.createElement('div');\n bye.textContent = \"Say Bye to \" + to.name;\n return bye;\n};\n\n//# sourceURL=webpack:///./app/bye.js?");
}),
"./app/hello.js": (function(module, exports) {
eval("module.exports = function() {\n var hello = document.createElement('div');\n hello.textContent = \"Say Hello!\";\n return hello;\n};\n\n//# sourceURL=webpack:///./app/hello.js?");
}),
"./app/main.js": (function(module, exports, __webpack_require__) {
eval("const hello = __webpack_require__(/*! ./hello.js */ \"./app/hello.js\");\nconst bye = __webpack_require__(/*! ./bye.js */ \"./app/bye.js\");\n\ndocument.querySelector(\"#root\").appendChild(hello()).appendChild(bye());;\n\n//# sourceURL=webpack:///./app/main.js?");
}),
"./app/to.js": (function(module, exports) {
eval("module.exports = {name: \"小明\"};\n\n//# sourceURL=webpack:///./app/to.js?");
})
});
分析
webpack 的運(yùn)行過程可分為：讀取配置參數(shù)，實(shí)例化插件，模塊解析處理（loader），輸出打包文件；在上面例子中，僅為 JavaScript 的引用，沒有使用插件和像CSS、less、圖片之類需要loader處理的模塊，所以上面的例子，過程只有讀取配置，識(shí)別入口及其引用模塊，打包幾步，生成最終的 bundle.js 文件。
簡單描述下 webpack 在這個(gè)過程中的執(zhí)行流程：在配置文件中讀取入口，如果有配置 plugins 參數(shù)，那么也是在此時(shí)進(jìn)行插件的實(shí)例化和鉤子函數(shù)的綁定；模塊解析，也就是loader加入的時(shí)刻，從入口文件開始，根據(jù)入口文件對(duì)其他模塊的依賴，結(jié)合配置文件中對(duì)不同種類型文件所使用的 loader（加載器） 說明，一個(gè)一個(gè)逐級(jí)對(duì)這些模塊進(jìn)行解析處理，或壓縮，或轉(zhuǎn)義，生成瀏覽器可以直接識(shí)別的內(nèi)容；最后將所有模塊進(jìn)行打包，輸出打包后的文件。在上面的代碼中，已經(jīng)對(duì) bundle.js 內(nèi)容進(jìn)行了內(nèi)容注釋，下面我們來分析下 bundle.js 的執(zhí)行過程：
1、自執(zhí)行函數(shù)
最后的輸出的文件 bundle.js 是一個(gè) JavaScript 文件，其本身其實(shí)是一個(gè)自執(zhí)行函數(shù)
(function(參數(shù)){})(參數(shù))。
2、參數(shù)
自執(zhí)行方法的參數(shù)為所有模塊組成的對(duì)象，key 為各個(gè)模塊的路徑，值為各模塊內(nèi)部的執(zhí)行代碼，觀察參數(shù)內(nèi)部的代碼，對(duì)比打包前的源碼，可以發(fā)現(xiàn)凡是 require 都變成了__webpack_require__這個(gè)webpack自定義的模塊調(diào)用方法，而且源碼中的相對(duì)路徑也變成了最終執(zhí)行位置的文件的相對(duì)路徑。
{
"./app/bye.js": (function(module, exports, __webpack_require__) {
eval("const to = __webpack_require__(/*! ./to.js */ \"./app/to.js\");\nmodule.exports = function() {\n var bye = document.createElement('div');\n bye.textContent = \"Say Bye to \" + to.name;\n return bye;\n};\n\n//# sourceURL=webpack:///./app/bye.js?");
}),
"./app/hello.js": (function(module, exports) {
eval("module.exports = function() {\n var hello = document.createElement('div');\n hello.textContent = \"Say Hello!\";\n return hello;\n};\n\n//# sourceURL=webpack:///./app/hello.js?");
}),
"./app/main.js": (function(module, exports, __webpack_require__) {
eval("const hello = __webpack_require__(/*! ./hello.js */ \"./app/hello.js\");\nconst bye = __webpack_require__(/*! ./bye.js */ \"./app/bye.js\");\n\ndocument.querySelector(\"#root\").appendChild(hello()).appendChild(bye());;\n\n//# sourceURL=webpack:///./app/main.js?");
}),
"./app/to.js": (function(module, exports) {
eval("module.exports = {name: \"小明\"};\n\n//# sourceURL=webpack:///./app/to.js?");
})
}
3、執(zhí)行
（1）自執(zhí)行文件開始執(zhí)行后，到自執(zhí)行函數(shù)最底部，首先從入口文件開始加載
return __webpack_require__(__webpack_require__.s = "./app/main.js");
（2）__webpack_require__函數(shù)被調(diào)用，傳入?yún)?shù) ./app/main.js，
function __webpack_require__(moduleId) {
// moduleId 為 ./app/main.js
// 首次進(jìn)來，未加載，模塊還沒有緩存
if(installedModules[moduleId]) {
return installedModules[moduleId].exports;
}
// 新建 ./app/main.js 模塊，并存于緩存
var module = installedModules[moduleId] = {
i: moduleId,
l: false,
exports: {}
};
modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
// 標(biāo)記模塊已經(jīng)加載
module.l = true;
// 輸出模塊的內(nèi)容
return module.exports;
}
此時(shí)方法中執(zhí)行 modules[moduleId].call(module.exports, module, module.exports,__webpack_require__); 相當(dāng)于在名為 ./app/main.js 的模塊中執(zhí)行如下代碼：
(function(module, exports, __webpack_require__) {
eval("const hello = __webpack_require__(/*! ./hello.js */ \"./app/hello.js\");\nconst bye = __webpack_require__(/*! ./bye.js */ \"./app/bye.js\");\n\ndocument.querySelector(\"#root\").appendChild(hello()).appendChild(bye());;\n\n//# sourceURL=webpack:///./app/main.js?");
})()
由于引用關(guān)系，接下來會(huì)再次執(zhí)行兩次__webpack_require__方法，分別傳參模塊路徑 ./app/hello.js 和 ./app/bye.js；
（3）執(zhí)行第一個(gè)__webpack_require__過程，除了傳參不同、執(zhí)行的模塊不同，與第二步基本一致，再次找到了依賴模塊 to.js，再次調(diào)用__webpack_require__。
"./app/hello.js": (function(module, exports, __webpack_require__) {
eval("const to = __webpack_require__(/*! ./to.js */ \"./app/to.js\");\nmodule.exports = function() {\n var hello = document.createElement('div');\n hello.textContent = \"Say Hello to \" + to.name;\n return hello;\n};\n\n//# sourceURL=webpack:///./app/hello.js?");
}),
（4）執(zhí)行第二個(gè)__webpack_require__時(shí)，在 bye.js 中找到了對(duì)于 to.js 的依賴，所以將繼續(xù)調(diào)用__webpack_require__方法，只是傳參變成了./app/to.js，達(dá)到終點(diǎn)。
"./app/bye.js": (function(module, exports, __webpack_require__) {
eval("const to = __webpack_require__(/*! ./to.js */ \"./app/to.js\");\nmodule.exports = function() {\n var bye = document.createElement('div');\n bye.textContent = \"Say Bye to \" + to.name;\n return bye;\n};\n\n//# sourceURL=webpack:///./app/bye.js?");
})
（5）到此時(shí)，整個(gè)從入口文件的開始的針對(duì)所依賴模塊的解析已經(jīng)完成，所有的 js 代碼也已經(jīng)引用完畢且放到了 bundle.js 中。
總結(jié)
到這里可以看到，webpack對(duì)js的打包，就是封裝為一個(gè)個(gè)單獨(dú)的方法，通過對(duì)這些方法的引用，達(dá)到模塊化的效果；而打包的過程，就是查找、解析、封裝這些方法的過程，整個(gè)執(zhí)行路徑類似于一棵樹，從主干出發(fā)，沿著樹枝遞歸式的執(zhí)行“require”方法，而且是直到這一根樹枝走到盡頭的時(shí)候才回頭尋找其他的方法，由于node的單線程，當(dāng)項(xiàng)目龐大或者模塊間依賴錯(cuò)綜復(fù)雜時(shí)，webpack打包會(huì)更加的耗費(fèi)時(shí)間。
以上為對(duì)webpack4.x中針對(duì)js模塊處理的簡單理解，主要基于官方文檔的介紹和打包后文件的分析，源碼讀起來還是比較難懂，暫時(shí)不敢照量。對(duì)于 ES6、AMD 的模塊化方式，代碼分割的等，后續(xù)再進(jìn)行補(bǔ)充。希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
JS 實(shí)現(xiàn)Json查詢的方法實(shí)例
曾經(jīng)看過一個(gè)大牛寫的實(shí)現(xiàn)Json的一個(gè)模板類，今天突然沒事就來自己試著寫寫。還好，一些東西還記得，思路還算清晰。直接上代碼了2013-04-04
JS操作時(shí)間 - UNIX時(shí)間戳的簡單介紹(必看篇)
下面小編就為大家?guī)硪黄狫S操作時(shí)間 - UNIX時(shí)間戳的簡單介紹(必看篇)。小編覺得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-08-08
這篇文章主要為大家詳細(xì)介紹了可拖拽組件slider.js的使用方法，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2020-12-12
使用JavaScript動(dòng)態(tài)設(shè)置樣式實(shí)現(xiàn)代碼及演示動(dòng)畫
使用onmouseover和onmouseout事件實(shí)現(xiàn)不同的效果而且是使用js動(dòng)態(tài)實(shí)現(xiàn)，本文有利于鞏固你js與css方面的知識(shí)，感興趣的你可以了解下哦，希望本文對(duì)你有所幫助2013-01-01
本文給大家介紹js控制偽元素的方法匯總，本文涉及到獲取偽元素屬性值的方法，本文介紹的非常詳細(xì)，具有參考借鑒價(jià)值，感興趣的朋友一起學(xué)習(xí)吧2016-04-04
bootstrap datetimepicker日期插件使用方法
這篇文章主要為大家詳細(xì)介紹了bootstrap datetimepicker的使用方法，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-01-01
這篇文章主要給大家介紹了關(guān)于Webpack按需加載打包c(diǎn)hunk命名的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用Webpack具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2019-09-09
JS實(shí)現(xiàn)定時(shí)任務(wù)每隔N秒請(qǐng)求后臺(tái)setInterval定時(shí)和ajax請(qǐng)求問題
這篇文章主要介紹了JS實(shí)現(xiàn)定時(shí)任務(wù)每隔N秒請(qǐng)求后臺(tái)setInterval定時(shí)和ajax請(qǐng)求 的相關(guān)資料,需要的朋友可以參考下2017-10-10
JavaScript 處理樹數(shù)據(jù)結(jié)構(gòu)的方法示例
這篇文章主要介紹了JavaScript 處理樹數(shù)據(jù)結(jié)構(gòu)的方法示例，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-06-06
本文通過實(shí)例代碼給大家介紹了JS中定位 position 的使用，非常不錯(cuò)，具有參考借鑒價(jià)值，需要的朋友參考下吧2017-08-08