webpack/examples/extra-async-chunk/README.md

390 lines
12 KiB
Markdown
Raw Normal View History

This example shows automatically created async commons chunks.
2015-01-12 06:17:24 +08:00
The example entry references two chunks:
* entry chunk
* async require -> chunk X
* async require -> chunk Y
* chunk X
* module `a`
* module `b`
* module `c`
* chunk Y
* module `a`
* module `b`
* module `d`
These chunks share modules `a` and `b`. The optimization extract these into chunk Z:
2018-02-26 10:39:48 +08:00
Note: Actually the optimization compare size of chunk Z to some minimum value, but this is disabled from this example. In practice there is no configuration needed for this.
2015-01-12 06:17:24 +08:00
* entry chunk
* async require -> chunk X & Z
* async require -> chunk Y & Z
* chunk X
* module `c`
* chunk Y
* module `d`
* chunk Z
* module `a`
* module `b`
Pretty useful for a router in a SPA.
# example.js
``` javascript
// a chunks with a, b, c
require(["./a", "./b", "./c"]);
// a chunk with a, b, d
require.ensure(["./a"], function(require) {
require("./b");
require("./d");
});
```
# dist/output.js
2017-03-31 02:42:42 +08:00
<details><summary><code>/******/ (function(modules) { /* webpackBootstrap */ })</code></summary>
``` javascript
/******/ (function(modules) { // webpackBootstrap
/******/ // install a JSONP callback for chunk loading
2017-11-23 16:47:19 +08:00
/******/ 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];
2017-05-23 04:45:18 +08:00
/******/ if(installedChunks[chunkId]) {
2016-02-04 07:27:47 +08:00
/******/ resolves.push(installedChunks[chunkId][0]);
2017-05-23 04:45:18 +08:00
/******/ }
/******/ installedChunks[chunkId] = 0;
/******/ }
/******/ for(moduleId in moreModules) {
2016-06-06 02:51:44 +08:00
/******/ if(Object.prototype.hasOwnProperty.call(moreModules, moduleId)) {
/******/ modules[moduleId] = moreModules[moduleId];
/******/ }
/******/ }
2017-11-23 16:47:19 +08:00
/******/ if(parentJsonpFunction) parentJsonpFunction(data);
2017-05-23 04:45:18 +08:00
/******/ while(resolves.length) {
2016-02-04 07:27:47 +08:00
/******/ resolves.shift()();
2017-05-23 04:45:18 +08:00
/******/ }
2017-03-31 02:25:01 +08:00
/******/
/******/ };
2017-03-31 02:25:01 +08:00
/******/
/******/
/******/ // The module cache
/******/ var installedModules = {};
2017-03-31 02:25:01 +08:00
/******/
2017-11-23 16:47:19 +08:00
/******/ // object to store loaded and loading chunks
/******/ var installedChunks = {
2016-09-07 18:28:56 +08:00
/******/ 3: 0
/******/ };
2017-03-31 02:25:01 +08:00
/******/
/******/
2017-11-23 16:47:19 +08:00
/******/
/******/ // The require function
/******/ function __webpack_require__(moduleId) {
2017-03-31 02:25:01 +08:00
/******/
/******/ // Check if module is in cache
2017-05-23 04:45:18 +08:00
/******/ if(installedModules[moduleId]) {
/******/ return installedModules[moduleId].exports;
2017-05-23 04:45:18 +08:00
/******/ }
/******/ // Create a new module (and put it into the cache)
/******/ var module = installedModules[moduleId] = {
2016-06-06 02:51:44 +08:00
/******/ i: moduleId,
/******/ l: false,
/******/ exports: {}
/******/ };
2017-03-31 02:25:01 +08:00
/******/
/******/ // Execute the module function
/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
2017-03-31 02:25:01 +08:00
/******/
/******/ // Flag the module as loaded
2016-06-06 02:51:44 +08:00
/******/ module.l = true;
2017-03-31 02:25:01 +08:00
/******/
/******/ // Return the exports of the module
/******/ return module.exports;
/******/ }
2017-03-31 02:25:01 +08:00
/******/
/******/ // This file contains only the entry chunk.
/******/ // The chunk loading function for additional chunks
2016-02-04 07:27:47 +08:00
/******/ __webpack_require__.e = function requireEnsure(chunkId) {
2017-11-23 16:47:19 +08:00
/******/ var promises = [];
2017-03-31 02:25:01 +08:00
/******/
/******/
2017-11-23 16:47:19 +08:00
/******/ // JSONP chunk loading for javascript
2017-03-31 02:25:01 +08:00
/******/
2017-11-23 16:47:19 +08:00
/******/ var installedChunkData = installedChunks[chunkId];
/******/ if(installedChunkData !== 0) { // 0 means "already installed".
2017-03-31 02:25:01 +08:00
/******/
2017-11-23 16:47:19 +08:00
/******/ // 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');
2018-01-05 04:14:02 +08:00
/******/
2017-11-23 16:47:19 +08:00
/******/ script.charset = 'utf-8';
/******/ script.timeout = 120000;
/******/
/******/ if (__webpack_require__.nc) {
/******/ script.setAttribute("nonce", __webpack_require__.nc);
2017-05-23 04:45:18 +08:00
/******/ }
2017-11-23 16:47:19 +08:00
/******/ 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);
2016-02-04 07:27:47 +08:00
/******/ }
2017-11-23 16:47:19 +08:00
/******/ }
/******/ return Promise.all(promises);
/******/ };
2017-03-31 02:25:01 +08:00
/******/
/******/ // expose the modules object (__webpack_modules__)
/******/ __webpack_require__.m = modules;
2017-03-31 02:25:01 +08:00
/******/
/******/ // expose the module cache
/******/ __webpack_require__.c = installedModules;
2017-03-31 02:25:01 +08:00
/******/
2016-12-08 02:14:47 +08:00
/******/ // define getter function for harmony exports
2016-09-07 18:28:56 +08:00
/******/ __webpack_require__.d = function(exports, name, getter) {
2016-12-14 19:03:24 +08:00
/******/ if(!__webpack_require__.o(exports, name)) {
/******/ Object.defineProperty(exports, name, {
/******/ configurable: false,
/******/ enumerable: true,
/******/ get: getter
/******/ });
/******/ }
2016-09-07 18:28:56 +08:00
/******/ };
2017-03-31 02:25:01 +08:00
/******/
2017-11-24 15:40:39 +08:00
/******/ // define __esModule on exports
/******/ __webpack_require__.r = function(exports) {
/******/ Object.defineProperty(exports, '__esModule', { value: true });
/******/ };
/******/
2016-09-07 18:28:56 +08:00
/******/ // 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;
/******/ };
2017-03-31 02:25:01 +08:00
/******/
2016-09-07 18:28:56 +08:00
/******/ // Object.prototype.hasOwnProperty.call
/******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
2017-03-31 02:25:01 +08:00
/******/
2016-02-04 20:02:53 +08:00
/******/ // __webpack_public_path__
/******/ __webpack_require__.p = "dist/";
2017-03-31 02:25:01 +08:00
/******/
2016-02-04 07:27:47 +08:00
/******/ // on error function for async loading
2016-06-06 02:51:44 +08:00
/******/ __webpack_require__.oe = function(err) { console.error(err); throw err; };
2017-03-31 02:25:01 +08:00
/******/
2017-11-23 16:47:19 +08:00
/******/ var jsonpArray = window["webpackJsonp"] = window["webpackJsonp"] || [];
/******/ var oldJsonpFunction = jsonpArray.push.bind(jsonpArray);
2017-11-23 16:47:19 +08:00
/******/ jsonpArray.push = webpackJsonpCallback;
/******/ jsonpArray = jsonpArray.slice();
/******/ for(var i = 0; i < jsonpArray.length; i++) webpackJsonpCallback(jsonpArray[i]);
/******/ var parentJsonpFunction = oldJsonpFunction;
/******/
2017-11-23 16:47:19 +08:00
/******/
/******/ // Load entry module and return exports
2017-06-05 22:12:12 +08:00
/******/ return __webpack_require__(__webpack_require__.s = 2);
/******/ })
/************************************************************************/
2016-09-07 18:28:56 +08:00
```
2017-03-31 02:42:42 +08:00
2016-09-07 18:28:56 +08:00
</details>
2017-03-31 02:42:42 +08:00
2016-09-07 18:28:56 +08:00
``` javascript
2016-02-04 07:27:47 +08:00
/******/ ({
2017-06-05 22:12:12 +08:00
/***/ 2:
/*!********************!*\
!*** ./example.js ***!
\********************/
2017-06-05 22:12:12 +08:00
/*! no static exports found */
2017-03-31 02:25:01 +08:00
/***/ (function(module, exports, __webpack_require__) {
2016-09-07 18:28:56 +08:00
// a chunks with a, b, c
Promise.all(/*! AMD require */[__webpack_require__.e(0), __webpack_require__.e(2)]).then(function() {[__webpack_require__(/*! ./a */ 1), __webpack_require__(/*! ./b */ 0), __webpack_require__(/*! ./c */ 4)];}).catch(__webpack_require__.oe);
2016-09-07 18:28:56 +08:00
// a chunk with a, b, d
2018-01-03 18:03:20 +08:00
Promise.all(/*! require.ensure */[__webpack_require__.e(0), __webpack_require__.e(1)]).then((function(require) {
2017-12-21 18:19:53 +08:00
__webpack_require__(/*! ./b */ 0);
__webpack_require__(/*! ./d */ 3);
2016-12-14 19:03:24 +08:00
}).bind(null, __webpack_require__)).catch(__webpack_require__.oe);
2017-03-31 02:25:01 +08:00
/***/ })
2016-02-04 07:27:47 +08:00
/******/ });
```
# dist/0.output.js
``` javascript
2017-11-23 16:47:19 +08:00
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([[0],[
2016-02-04 07:27:47 +08:00
/* 0 */
/*!**************!*\
2017-12-21 18:19:53 +08:00
!*** ./b.js ***!
2016-02-04 07:27:47 +08:00
\**************/
2017-06-05 22:12:12 +08:00
/*! no static exports found */
2017-03-31 02:25:01 +08:00
/***/ (function(module, exports) {
2017-12-21 18:19:53 +08:00
module.exports = "b";
2016-02-04 07:27:47 +08:00
2017-03-31 02:25:01 +08:00
/***/ }),
2016-02-04 07:27:47 +08:00
/* 1 */
/*!**************!*\
2017-12-21 18:19:53 +08:00
!*** ./a.js ***!
\**************/
2017-06-05 22:12:12 +08:00
/*! no static exports found */
2017-03-31 02:25:01 +08:00
/***/ (function(module, exports) {
2017-12-21 18:19:53 +08:00
module.exports = "a";
2017-03-31 02:25:01 +08:00
/***/ })
2017-11-23 16:47:19 +08:00
]]);
```
# dist/1.output.js
``` javascript
2017-11-23 16:47:19 +08:00
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([[1],{
2017-12-21 18:19:53 +08:00
/***/ 3:
/*!**************!*\
!*** ./d.js ***!
\**************/
2017-06-05 22:12:12 +08:00
/*! no static exports found */
2017-03-31 02:25:01 +08:00
/***/ (function(module, exports) {
2016-09-07 18:28:56 +08:00
module.exports = "d";
2017-03-31 02:25:01 +08:00
/***/ })
2017-11-23 16:47:19 +08:00
}]);
```
# dist/2.output.js
``` javascript
2017-11-23 16:47:19 +08:00
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([[2],{
2017-12-21 18:19:53 +08:00
/***/ 4:
/*!**************!*\
2016-02-04 07:27:47 +08:00
!*** ./c.js ***!
\**************/
2017-06-05 22:12:12 +08:00
/*! no static exports found */
2017-03-31 02:25:01 +08:00
/***/ (function(module, exports) {
2016-09-07 18:28:56 +08:00
module.exports = "c";
2017-03-31 02:25:01 +08:00
/***/ })
2016-02-04 07:27:47 +08:00
2017-11-23 16:47:19 +08:00
}]);
```
# Info
2017-12-14 17:58:03 +08:00
## Unoptimized
```
2017-12-14 17:58:03 +08:00
Hash: 0a1b2c3d4e5f6a7b8c9d
2018-02-17 21:14:14 +08:00
Version: webpack 4.0.0-beta.2
Asset Size Chunks Chunk Names
2017-12-14 17:58:03 +08:00
0.output.js 405 bytes 0 [emitted]
1.output.js 241 bytes 1 [emitted]
2.output.js 241 bytes 2 [emitted]
2018-02-17 21:14:14 +08:00
output.js 7.32 KiB 3 [emitted] main
2016-09-07 18:28:56 +08:00
Entrypoint main = output.js
2018-01-22 22:18:54 +08:00
chunk {0} 0.output.js 42 bytes <{3}> ={1}= ={2}= [rendered] split chunk (cache group: default)
> ./a ./b ./c [2] ./example.js 2:0-30
2018-02-17 21:14:14 +08:00
> [2] ./example.js 5:0-8:2
2017-12-21 18:19:53 +08:00
[0] ./b.js 21 bytes {0} [built]
amd require ./b [2] ./example.js 2:0-30
2017-06-05 22:12:12 +08:00
cjs require ./b [2] ./example.js 6:1-15
2017-12-21 18:19:53 +08:00
[1] ./a.js 21 bytes {0} [built]
amd require ./a [2] ./example.js 2:0-30
2017-12-21 18:19:53 +08:00
require.ensure item ./a [2] ./example.js 5:0-8:2
chunk {1} 1.output.js 21 bytes <{3}> ={0}= [rendered]
2017-06-05 22:12:12 +08:00
> [2] ./example.js 5:0-8:2
2017-12-21 18:19:53 +08:00
[3] ./d.js 21 bytes {1} [built]
2017-06-05 22:12:12 +08:00
cjs require ./d [2] ./example.js 7:1-15
chunk {2} 2.output.js 21 bytes <{3}> ={0}= [rendered]
> ./a ./b ./c [2] ./example.js 2:0-30
2017-12-21 18:19:53 +08:00
[4] ./c.js 21 bytes {2} [built]
amd require ./c [2] ./example.js 2:0-30
2018-02-17 21:14:14 +08:00
chunk {3} output.js (main) 172 bytes >{0}< >{1}< >{2}< [entry] [rendered]
> .\example.js main
2018-02-17 21:14:14 +08:00
[2] ./example.js 172 bytes {3} [built]
2017-11-23 16:47:19 +08:00
single entry .\example.js main
```
2017-12-14 17:58:03 +08:00
## Production mode
```
2017-12-14 17:58:03 +08:00
Hash: 0a1b2c3d4e5f6a7b8c9d
2018-02-17 21:14:14 +08:00
Version: webpack 4.0.0-beta.2
2017-11-23 16:47:19 +08:00
Asset Size Chunks Chunk Names
0.output.js 118 bytes 0 [emitted]
1.output.js 91 bytes 1 [emitted]
2.output.js 91 bytes 2 [emitted]
output.js 1.73 KiB 3 [emitted] main
2016-09-07 18:28:56 +08:00
Entrypoint main = output.js
2018-01-22 22:18:54 +08:00
chunk {0} 0.output.js 42 bytes <{3}> ={1}= ={2}= [rendered] split chunk (cache group: default)
> ./a ./b ./c [2] ./example.js 2:0-30
2018-02-17 21:14:14 +08:00
> [2] ./example.js 5:0-8:2
2017-12-21 18:19:53 +08:00
[0] ./b.js 21 bytes {0} [built]
amd require ./b [2] ./example.js 2:0-30
2017-06-05 22:12:12 +08:00
cjs require ./b [2] ./example.js 6:1-15
2017-12-21 18:19:53 +08:00
[1] ./a.js 21 bytes {0} [built]
amd require ./a [2] ./example.js 2:0-30
2017-12-21 18:19:53 +08:00
require.ensure item ./a [2] ./example.js 5:0-8:2
chunk {1} 1.output.js 21 bytes <{3}> ={0}= [rendered]
2017-06-05 22:12:12 +08:00
> [2] ./example.js 5:0-8:2
2017-12-21 18:19:53 +08:00
[3] ./d.js 21 bytes {1} [built]
2017-06-05 22:12:12 +08:00
cjs require ./d [2] ./example.js 7:1-15
chunk {2} 2.output.js 21 bytes <{3}> ={0}= [rendered]
> ./a ./b ./c [2] ./example.js 2:0-30
2017-12-21 18:19:53 +08:00
[4] ./c.js 21 bytes {2} [built]
amd require ./c [2] ./example.js 2:0-30
2018-02-17 21:14:14 +08:00
chunk {3} output.js (main) 172 bytes >{0}< >{1}< >{2}< [entry] [rendered]
> .\example.js main
2018-02-17 21:14:14 +08:00
[2] ./example.js 172 bytes {3} [built]
2017-11-23 16:47:19 +08:00
single entry .\example.js main
```