本文针对Webpack懒加载构建和加载的原理，对构建后的源码进行分析。
一.准备工作
首先,init之后创建一个简单的webpack基本的配置,在src目录下创建两个js文件（一个主入口文件和一个非主入口文件）和一个html文件,package.json，webpack.config.js公共部分代码如下：
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title></title> </head> <body> <button id="oBtn">按钮加载</button> </body> </html>
//入口js文件 let oBtn=document.getElementById('oBtn') oBtn.addEventListener('click',function(){ import (/*webpackChunkName:"index1"*/'./index1.js').then((index1)=>{ console.log(index1) }) })
//非入口文件 module.exports="我是张三"
//package.json { "name": "mywebpack", "version": "1.0.0", "main": "index.js", "license": "MIT", "devDependencies": { "html-webpack-plugin": "4.5.0", "webpack": "4.44.2", "webpack-cli": "3.3.12" } }
//webpack.config.js const path = require('path') const HtmlWebpackPlugin = require('html-webpack-plugin') module.exports = { devtool: 'none', mode: 'development', entry: './src/index.js', output: { filename: 'built.js', path: path.resolve('dist') }, plugins: [ new HtmlWebpackPlugin({ template: './src/index.html' }) ] }
二.执行打包操作
yarn webpack执行操作打包之后生成built.js.index1.built.js,index.html,
从上文中入口js的代码可分析出 import (/*webpackChunkName:"index1"*/'./index1.js')可以实现指定的懒加载操作。
下面是打包之后的源码index.html,built.js,index1.built.js
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title></title> </head> <body> <button id="oBtn">按钮加载</button> <script src="built.js"></script></body> </html>
//built.js (function(modules) { // webpackBootstrap // install a JSONP callback for chunk loading function webpackJsonpCallback(data) { var chunkIds = data[0]; var moreModules = data[1]; // add "moreModules" to the modules object, // then flag all "chunkIds" as loaded and fire callback var moduleId, chunkId, i = 0, resolves = []; for(;i < chunkIds.length; i++) { chunkId = chunkIds[i]; if(Object.prototype.hasOwnProperty.call(installedChunks, chunkId) && installedChunks[chunkId]) { resolves.push(installedChunks[chunkId][0]); } installedChunks[chunkId] = 0; } for(moduleId in moreModules) { if(Object.prototype.hasOwnProperty.call(moreModules, moduleId)) { modules[moduleId] = moreModules[moduleId]; } } if(parentJsonpFunction) parentJsonpFunction(data); while(resolves.length) { resolves.shift()(); } }; // The module cache var installedModules = {}; // object to store loaded and loading chunks // undefined = chunk not loaded, null = chunk preloaded/prefetched // Promise = chunk loading, 0 = chunk loaded var installedChunks = { "main": 0 }; // script path function function jsonpScriptSrc(chunkId) { return __webpack_require__.p + "" + chunkId + ".built.js" } // The require function function __webpack_require__(moduleId) { // Check if module is in cache if(installedModules[moduleId]) { return installedModules[moduleId].exports; } // Create a new module (and put it into the cache) var module = installedModules[moduleId] = { i: moduleId, l: false, exports: {} }; // Execute the module function modules[moduleId].call(module.exports, module, module.exports, __webpack_require__); // Flag the module as loaded module.l = true; // Return the exports of the module return module.exports; } // This file contains only the entry chunk. // The chunk loading function for additional chunks __webpack_require__.e = function requireEnsure(chunkId) { var promises = []; // JSONP chunk loading for javascript var installedChunkData = installedChunks[chunkId]; if(installedChunkData !== 0) { // 0 means "already installed". // a Promise means "currently loading". if(installedChunkData) { promises.push(installedChunkData[2]); } else { // setup Promise in chunk cache var promise = new Promise(function(resolve, reject) { installedChunkData = installedChunks[chunkId] = [resolve, reject]; }); promises.push(installedChunkData[2] = promise); // start chunk loading var script = document.createElement('script'); var onScriptComplete; script.charset = 'utf-8'; script.timeout = 120; if (__webpack_require__.nc) { script.setAttribute("nonce", __webpack_require__.nc); } script.src = jsonpScriptSrc(chunkId); // create error before stack unwound to get useful stacktrace later var error = new Error(); onScriptComplete = function (event) { // avoid mem leaks in IE. script.onerror = script.onload = null; clearTimeout(timeout); var chunk = installedChunks[chunkId]; if(chunk !== 0) { if(chunk) { var errorType = event && (event.type === 'load' ? 'missing' : event.type); var realSrc = event && event.target && event.target.src; error.message = 'Loading chunk ' + chunkId +
' failed. (' + errorType + ': ' + realSrc + ')'; error.name = 'ChunkLoadError'; error.type = errorType; error.request = realSrc; chunk[1](error); } installedChunks[chunkId] = undefined; } }; var timeout = setTimeout(function(){ onScriptComplete({ type: 'timeout', target: script }); }, 120000); script.onerror = script.onload = onScriptComplete; document.head.appendChild(script); } } return Promise.all(promises); }; // expose the modules object (__webpack_modules__) __webpack_require__.m = modules; // expose the module cache __webpack_require__.c = installedModules; // define getter function for harmony exports __webpack_require__.d = function(exports, name, getter) { if(!__webpack_require__.o(exports, name)) { Object.defineProperty(exports, name, { enumerable: true, get: getter }); } }; // 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 }); }; // 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; }; // 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 __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); }; __webpack_require__.p = ""; __webpack_require__.oe = function(err) { console.error(err); throw err; }; var jsonpArray = window["webpackJsonp"] = window["webpackJsonp"] || []; var oldJsonpFunction = jsonpArray.push.bind(jsonpArray); jsonpArray.push = webpackJsonpCallback; jsonpArray = jsonpArray.slice(); for(var i = 0; i < jsonpArray.length; i++) webpackJsonpCallback(jsonpArray[i]); var parentJsonpFunction = oldJsonpFunction; return __webpack_require__(__webpack_require__.s = "./src/index.js"); }) /************************************************************************/ ({ "./src/index.js": (function(module, exports, __webpack_require__) { //入口js文件 let oBtn=document.getElementById('oBtn') oBtn.addEventListener('click',function(){ __webpack_require__.e(/*! import() | index1 */ "index1") .then(__webpack_require__.t.bind(null, /*! ./index1.js */ "./src/index1.js", 7)) .then((index1)=>{ console.log(index1) }) }) }) });
//index1.js
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([["index1"],{ "./src/index1.js": (function(module, exports) { module.exports="我是张三" }) }]);
三.打包之后代码块解析
__webpack_require__.e 实现jsonp加载内容 利用promise来实现异步加载操作
__webpack_require__.e = function requireEnsure(chunkId) { var promises = []; //判断installedChunks是否存在对应id的值 var installedChunkData = installedChunks[chunkId];
//0 表示已经加载 promise 表示正在加载 undefined 表示没有加载 if(installedChunkData !== 0) { // a Promise means "currently loading". if(installedChunkData) {
//把完整的promise push到数组中 promises.push(installedChunkData[2]); } else { // 不存在创建promise var promise = new Promise(function(resolve, reject) { installedChunkData = installedChunks[chunkId] = [resolve, reject]; });
//把完整的promise push进数组 promises.push(installedChunkData[2] = promise); // 创建script标签 var script = document.createElement('script'); var onScriptComplete; script.charset = 'utf-8'; script.timeout = 120; if (__webpack_require__.nc) { script.setAttribute("nonce", __webpack_require__.nc); }
//设置src script.src = jsonpScriptSrc(chunkId); var error = new Error(); onScriptComplete = function (event) { // avoid mem leaks in IE. script.onerror = script.onload = null; clearTimeout(timeout); var chunk = installedChunks[chunkId]; if(chunk !== 0) { if(chunk) { var errorType = event && (event.type === 'load' ? 'missing' : event.type); var realSrc = event && event.target && event.target.src; error.message = 'Loading chunk ' + chunkId + ' failed. (' + errorType + ': ' + realSrc + ')'; error.name = 'ChunkLoadError'; error.type = errorType; error.request = realSrc; chunk[1](error); } installedChunks[chunkId] = undefined; } }; var timeout = setTimeout(function(){ onScriptComplete({ type: 'timeout', target: script }); }, 120000); script.onerror = script.onload = onScriptComplete; document.head.appendChild(script); } } return Promise.all(promises); };
该方法主要判断chunkId对应的模块是否已经加载了，如果已经加载了，就不再重新加载；
如果模块没有被加载过，但模块处于正在被加载的过程，不再重复加载，直接将加载模块的promise返回。
如果模块没有被加载过，也不处于加载过程，就创建一个promise，并将resolve、reject、promise构成的数组存储在上边说过的installedChunks缓存对象属性中。然后创建一个script标签加载对应的文件，加载超时时间是2分钟。如果script
文件加载失败，触发reject（对应源码中：chunk[1](error)，chunk[1]就是上边缓存的数组的第二个元素reject），并将installedChunks缓存对象中对应key的值设置为undefined，标识其没有被加载。
//定义变量存放数组 window里面是否有webpackJsonp的方法,如果没有设置为[]数组 var jsonpArray = window["webpackJsonp"] = window["webpackJsonp"] || []; //oldJsonpFunction保存旧的jsonpArray var oldJsonpFunction = jsonpArray.push.bind(jsonpArray); //重新定义push方法 jsonpArray.push = webpackJsonpCallback; jsonpArray = jsonpArray.slice(); for(var i = 0; i < jsonpArray.length; i++) webpackJsonpCallback(jsonpArray[i]); var parentJsonpFunction = oldJsonpFunction;
上述代码主要是定义了一个全局变量jsonpArray，并且重新定义了push方法，改变量为一个数组，该数组变量的原生push方法被复写为webpackJsonpCallback方法，该方法是懒加载实现的一个核心方法，作用是把子模块调用自定义的push方法
（webpackJsonpCallback）添加进去。
//该push方法实际上就是webpackJsonpCallback方法
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([["index1"],{ "./src/index1.js": (function(module, exports) { module.exports="我是张三" }) }]);
webpackJsonpCallback函数分析
function webpackJsonpCallback(data) { //获取需要被加载的模块id var chunkIds = data[0]; //获取需要被动态加载的模块依赖 var moreModules = data[1]; var moduleId, chunkId, i = 0, resolves = []; //循环判断 chunkIds 里对应的模块内容是否已经完成了加载 for(;i < chunkIds.length; i++) { chunkId = chunkIds[i]; //判断installedChunks[chunkId]是否存在,并且installedChunks的对象属性中有chunkId的值（正在加载中.） if(Object.prototype.hasOwnProperty.call(installedChunks, chunkId) && installedChunks[chunkId]) { //把resolve放进数组表明已加载完成 resolves.push(installedChunks[chunkId][0]); } //将chunkId对应的值设置为0 表明已经加载过 installedChunks[chunkId] = 0; } //对模块进行合并 for(moduleId in moreModules) { if(Object.prototype.hasOwnProperty.call(moreModules, moduleId)) { modules[moduleId] = moreModules[moduleId]; } } //加载后续内容 if(parentJsonpFunction) parentJsonpFunction(data); //如果存在调用resolves方法，执行后续的then操作 while(resolves.length) { resolves.shift()(); } };
定义webpackJsonpCallback 实现：合并模块定义,改变 promise 状态执行后续行为，
参数data为一个数组。有两个元素：第一个元素是要懒加载文件中所有模块的chunkId组成的数组；第二个参数是一个对象，对象的属性和值分别是要加载模块的moduleId和模块代码函数，
该函数的作用：
(1)遍历参数中的chunkId：
判断installedChunks缓存变量中对应chunkId的属性值：如果是真，说明模块正在加载，因为从上边分析中可以知道，installedChunks[chunkId]只有一种情况是真，那就是在对应的模块正在加载时，会将加载模块创建的promise组合
一个数组[resolve, reject, proimise]赋值给installedChunks[chunkId]。将resolve存入resolves变量中。将installedChunks中对应的chunkId置为0，该模块标识为已经被加载过。
(2)遍历参数中模块属性
将模块代码函数存储到modules中，该modules是入口文件built.js中自执行函数的参数。
(3)调用parentJsonpFunction（原生push方法）加载模块后续内容
(4)遍历resolves，执行所有promise的resolve
__webpack_require__.t方法解析
__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; };
__webpack_require__.t方法可以针对内容进行不同的处理（处理方式取决于传入的数值），它主要是做了这么几件事情
1 接收两个参数,一个是value一般用于表示被加载模块id,第二个值mode是一个二进制数值
2 t方法内部做的第一件事情就是调用自定义的require方法加载value对应的模块导出，重新赋值给value
3 当获取到value值之后 余下的84 2 ns都是对当前的内容进行加工处理,然后返回使用
4 当mode & 8成立直接将返回（比如0111 1000 不成立）（commonjs规范）
5 当mode & 4 成立时直接将value返回 （esmodule）
6 如果上述条件都不成立,还是继续处理value，定义一个ns {}
*6-1 如果拿到的value是一个可以直接使用的内容,例如是一个字符串，将它挂载到ns的default属性上
*6-2 如果不是一个简单数据类型调用d方法添加getter属性外部可以通过ns.name拿到值
/******************************************************************************************/
快乐很简单，就是春天的鲜花，夏天的绿荫，秋天的野果，冬天的漫天飞雪。