This example illustrates a very simple case of Code Splitting with `require.ensure`. * `a` and `b` are required normally via CommonJS * `c` is depended through the `require.ensure` array. * This means: make it available, but don't execute it * webpack will load it on demand * `b` and `d` are required via CommonJs in the `require.ensure` callback * webpack detects that these are in the on-demand-callback and * will load them on demand * webpacks optimizer can optimize `b` away * as it is already available through the parent chunks You can see that webpack outputs two files/chunks: * `output.js` is the entry chunk and contains * the module system * chunk loading logic * the entry point `example.js` * module `a` * module `b` * `1.js` is an additional chunk (on demand loaded) and contains * module `c` * module `d` You can see that chunks are loaded via JSONP. The additional chunks are pretty small and minimize well. # example.js ``` javascript var a = require("a"); var b = require("b"); require.ensure(["c"], function(require) { require("b").xyz(); var d = require("d"); }); ``` # dist/output.js
/******/ (function(modules) { /* webpackBootstrap */ }) ``` javascript /******/ (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(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 /******/ var installedChunks = { /******/ 1: 0 /******/ }; /******/ /******/ /******/ /******/ // 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 head = document.getElementsByTagName('head')[0]; /******/ var script = document.createElement('script'); /******/ /******/ script.charset = 'utf-8'; /******/ script.timeout = 120000; /******/ /******/ if (__webpack_require__.nc) { /******/ script.setAttribute("nonce", __webpack_require__.nc); /******/ } /******/ script.src = __webpack_require__.p + "" + chunkId + ".output.js"; /******/ var timeout = setTimeout(function(){ /******/ onScriptComplete({ type: 'timeout', target: script }); /******/ }, 120000); /******/ script.onerror = script.onload = onScriptComplete; /******/ function onScriptComplete(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; /******/ var error = new Error('Loading chunk ' + chunkId + ' failed.\n(' + errorType + ': ' + realSrc + ')'); /******/ error.type = errorType; /******/ error.request = realSrc; /******/ chunk[1](error); /******/ } /******/ installedChunks[chunkId] = undefined; /******/ } /******/ }; /******/ 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, { /******/ configurable: false, /******/ enumerable: true, /******/ get: getter /******/ }); /******/ } /******/ }; /******/ /******/ // define __esModule on exports /******/ __webpack_require__.r = function(exports) { /******/ Object.defineProperty(exports, '__esModule', { value: true }); /******/ }; /******/ /******/ // 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_public_path__ /******/ __webpack_require__.p = "dist/"; /******/ /******/ // on error function for async loading /******/ __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; /******/ /******/ /******/ // Load entry module and return exports /******/ return __webpack_require__(__webpack_require__.s = 2); /******/ }) /************************************************************************/ ```
``` javascript /******/ ([ /* 0 */ /*!***************************!*\ !*** ./node_modules/b.js ***! \***************************/ /*! no static exports found */ /***/ (function(module, exports) { // module b /***/ }), /* 1 */ /*!***************************!*\ !*** ./node_modules/a.js ***! \***************************/ /*! no static exports found */ /***/ (function(module, exports) { // module a /***/ }), /* 2 */ /*!********************!*\ !*** ./example.js ***! \********************/ /*! no static exports found */ /***/ (function(module, exports, __webpack_require__) { var a = __webpack_require__(/*! a */ 1); var b = __webpack_require__(/*! b */ 0); __webpack_require__.e(/*! require.ensure */ 0).then((function(require) { __webpack_require__(/*! b */ 0).xyz(); var d = __webpack_require__(/*! d */ 3); }).bind(null, __webpack_require__)).catch(__webpack_require__.oe); /***/ }) /******/ ]); ``` # dist/0.output.js ``` javascript (window["webpackJsonp"] = window["webpackJsonp"] || []).push([[0],[ /* 0 */, /* 1 */, /* 2 */, /* 3 */ /*!***************************!*\ !*** ./node_modules/d.js ***! \***************************/ /*! no static exports found */ /***/ (function(module, exports) { // module d /***/ }), /* 4 */ /*!***************************!*\ !*** ./node_modules/c.js ***! \***************************/ /*! no static exports found */ /***/ (function(module, exports) { // module c /***/ }) ]]); ``` Minimized ``` javascript (window.webpackJsonp=window.webpackJsonp||[]).push([[0],[,,,function(n,o){},function(n,o){}]]); ``` # Info ## Unoptimized ``` Hash: 0a1b2c3d4e5f6a7b8c9d Version: webpack next Asset Size Chunks Chunk Names 0.output.js 490 bytes 0 [emitted] output.js 7.47 KiB 1 [emitted] main Entrypoint main = output.js chunk {0} 0.output.js 22 bytes <{1}> [rendered] > [2] ./example.js 3:0-6:2 2 modules chunk {1} output.js (main) 166 bytes >{0}< [entry] [rendered] > .\example.js main [2] ./example.js 144 bytes {1} [built] single entry .\example.js main + 2 hidden modules ``` ## Production mode ``` Hash: 0a1b2c3d4e5f6a7b8c9d Version: webpack next Asset Size Chunks Chunk Names 0.output.js 95 bytes 0 [emitted] output.js 1.68 KiB 1 [emitted] main Entrypoint main = output.js chunk {0} 0.output.js 22 bytes <{1}> [rendered] > [2] ./example.js 3:0-6:2 2 modules chunk {1} output.js (main) 166 bytes >{0}< [entry] [rendered] > .\example.js main [2] ./example.js 144 bytes {1} [built] single entry .\example.js main + 2 hidden modules ```