webpack/examples/code-splitting-specify-chun.../README.md

435 lines
16 KiB
Markdown
Raw Normal View History

# example.js
This example illustrates how to specify chunk name in `require.ensure()` and `import()` to separated modules into separate chunks manually.
2019-04-09 02:29:40 +08:00
```javascript
2017-04-10 17:44:59 +08:00
import("./templates/foo" /* webpackChunkName: "chunk-foo" */ ).then(function(foo) {
console.log('foo:', foo);
})
require.ensure([], function(require) {
2017-04-10 17:44:59 +08:00
var foo = require("./templates/foo");
console.log('foo:', foo);
}, "chunk-foo1");
var createContextVar = "r";
2017-04-10 17:44:59 +08:00
import("./templates/ba" + createContextVar /* webpackChunkName: "chunk-bar-baz" */ ).then(function(bar) {
console.log('bar:', bar);
})
```
# templates/
2019-04-09 02:29:40 +08:00
- foo.js
- baz.js
- bar.js
All templates are of this pattern:
2019-04-09 02:29:40 +08:00
```javascript
var foo = "foo";
export default foo;
```
# dist/output.js
2019-04-09 02:29:40 +08:00
```javascript
2019-10-09 05:45:47 +08:00
/******/ ((modules, runtime) => { // webpackBootstrap
2018-12-19 21:05:17 +08:00
/******/ "use strict";
/******/ // The module cache
/******/ var installedModules = {};
/******/
/******/ // The require function
/******/ function __webpack_require__(moduleId) {
/******/
/******/ // 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] = {
/******/ i: moduleId,
/******/ l: false,
/******/ exports: {}
/******/ };
/******/
/******/ // Execute the module function
2019-10-09 05:45:47 +08:00
/******/ modules[moduleId](module, module.exports, __webpack_require__);
/******/
/******/ // Flag the module as loaded
/******/ module.l = true;
/******/
/******/ // Return the exports of the module
/******/ return module.exports;
/******/ }
/******/
/******/
/******/ // expose the modules object (__webpack_modules__)
/******/ __webpack_require__.m = modules;
/******/
2019-02-05 01:52:39 +08:00
/******/ // the startup function
/******/ function startup() {
/******/ // Load entry module and return exports
/******/ return __webpack_require__(0);
/******/ };
2018-12-19 21:05:17 +08:00
/******/ // initialize runtime
/******/ runtime(__webpack_require__);
2017-11-23 16:47:19 +08:00
/******/
2019-02-05 01:52:39 +08:00
/******/ // run startup
/******/ return startup();
/******/ })
/************************************************************************/
/******/ ([
2018-09-26 05:13:58 +08:00
/* 0 */
2018-09-25 23:08:35 +08:00
/*!********************!*\
!*** ./example.js ***!
\********************/
2019-08-05 19:32:25 +08:00
/*! exports [maybe provided (runtime-defined)] [no usage info] */
/*! runtime requirements: __webpack_require__, __webpack_require__.e */
2019-10-09 05:45:47 +08:00
/***/ ((__unusedmodule, __unusedexports, __webpack_require__) => {
2018-09-25 23:08:35 +08:00
2019-05-10 03:34:28 +08:00
__webpack_require__.e(/*! import() | chunk-foo */ 930).then(__webpack_require__.bind(null, /*! ./templates/foo */ 2)).then(function(foo) {
2018-09-25 23:08:35 +08:00
console.log('foo:', foo);
})
2019-05-10 03:34:28 +08:00
__webpack_require__.e(/*! require.ensure | chunk-foo1 */ 930).then((function(require) {
2018-09-26 05:13:58 +08:00
var foo = __webpack_require__(/*! ./templates/foo */ 2);
2018-09-25 23:08:35 +08:00
console.log('foo:', foo);
}).bind(null, __webpack_require__)).catch(__webpack_require__.oe);
var createContextVar = "r";
2018-09-26 05:13:58 +08:00
__webpack_require__(1)("./ba" + createContextVar).then(function(bar) {
2018-09-25 23:08:35 +08:00
console.log('bar:', bar);
})
/***/ }),
2018-09-26 05:13:58 +08:00
/* 1 */
2019-10-09 05:45:47 +08:00
/*!*****************************************************************************!*\
!*** ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ***!
\*****************************************************************************/
2019-08-05 19:32:25 +08:00
/*! exports [maybe provided (runtime-defined)] [no usage info] */
/*! runtime requirements: module, __webpack_require__, __webpack_require__.e */
2019-10-09 05:45:47 +08:00
/***/ ((module, __unusedexports, __webpack_require__) => {
var map = {
"./bar": [
2018-09-26 05:13:58 +08:00
3,
2019-05-10 03:34:28 +08:00
791
],
"./bar.js": [
2018-09-26 05:13:58 +08:00
3,
2019-05-10 03:34:28 +08:00
791
],
"./baz": [
2018-09-26 05:13:58 +08:00
4,
2019-05-10 03:34:28 +08:00
548
],
"./baz.js": [
2018-09-26 05:13:58 +08:00
4,
2019-05-10 03:34:28 +08:00
548
]
};
function webpackAsyncContext(req) {
2019-05-10 03:34:28 +08:00
if(!Object.prototype.hasOwnProperty.call(map, req)) {
2019-10-09 05:45:47 +08:00
return Promise.resolve().then(() => {
var e = new Error("Cannot find module '" + req + "'");
2018-01-03 18:03:20 +08:00
e.code = 'MODULE_NOT_FOUND';
throw e;
});
}
var ids = map[req], id = ids[0];
2019-10-09 05:45:47 +08:00
return __webpack_require__.e(ids[1]).then(() => {
2018-09-25 23:08:35 +08:00
return __webpack_require__(id);
});
2017-12-04 21:35:55 +08:00
}
webpackAsyncContext.keys = function webpackAsyncContextKeys() {
return Object.keys(map);
};
2018-09-26 05:13:58 +08:00
webpackAsyncContext.id = 1;
2017-08-08 20:00:06 +08:00
module.exports = webpackAsyncContext;
/***/ })
2018-12-19 21:05:17 +08:00
/******/ ],
```
<details><summary><code>function(__webpack_require__) { /* webpackRuntimeModules */ });</code></summary>
``` js
/******/ function(__webpack_require__) { // webpackRuntimeModules
/******/ "use strict";
/******/
/******/ /* webpack/runtime/ensure chunk */
/******/ !function() {
/******/ __webpack_require__.f = {};
/******/ // This file contains only the entry chunk.
/******/ // The chunk loading function for additional chunks
2019-10-09 05:45:47 +08:00
/******/ __webpack_require__.e = (chunkId) => {
/******/ return Promise.all(Object.keys(__webpack_require__.f).reduce((promises, key) => {
2019-08-05 19:32:25 +08:00
/******/ __webpack_require__.f[key](chunkId, promises);
/******/ return promises;
/******/ }, []));
2018-12-19 21:05:17 +08:00
/******/ };
/******/ }();
/******/
/******/ /* webpack/runtime/make namespace object */
/******/ !function() {
/******/ // define __esModule on exports
2019-10-09 05:45:47 +08:00
/******/ __webpack_require__.r = (exports) => {
2018-12-19 21:05:17 +08:00
/******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
/******/ }
/******/ Object.defineProperty(exports, '__esModule', { value: true });
/******/ };
/******/ }();
/******/
2019-10-09 05:45:47 +08:00
/******/ /* webpack/runtime/define property getters */
/******/ !function() {
/******/ // define getter functions for harmony exports
/******/ var hasOwnProperty = Object.prototype.hasOwnProperty;
/******/ __webpack_require__.d = (exports, definition) => {
/******/ for(var key in definition) {
/******/ if(hasOwnProperty.call(definition, key) && !hasOwnProperty.call(exports, key)) {
/******/ Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
/******/ }
/******/ }
/******/ };
/******/ }();
/******/
2018-12-19 21:05:17 +08:00
/******/ /* webpack/runtime/publicPath */
/******/ !function() {
/******/ __webpack_require__.p = "dist/";
/******/ }();
/******/
/******/ /* webpack/runtime/get javascript chunk filename */
/******/ !function() {
2019-05-10 03:34:28 +08:00
/******/ // This function allow to reference async chunks
2019-10-09 05:45:47 +08:00
/******/ __webpack_require__.u = (chunkId) => {
2019-02-05 01:52:39 +08:00
/******/ // return url for filenames based on template
2018-12-19 21:05:17 +08:00
/******/ return "" + chunkId + ".output.js";
/******/ };
/******/ }();
/******/
/******/ /* webpack/runtime/jsonp chunk loading */
/******/ !function() {
/******/
/******/
/******/ // object to store loaded and loading chunks
/******/ // undefined = chunk not loaded, null = chunk preloaded/prefetched
/******/ // Promise = chunk loading, 0 = chunk loaded
/******/ var installedChunks = {
2019-05-10 03:34:28 +08:00
/******/ 179: 0
2018-12-19 21:05:17 +08:00
/******/ };
/******/
/******/
/******/
2019-08-05 19:32:25 +08:00
/******/
2019-10-09 05:45:47 +08:00
/******/ __webpack_require__.f.j = (chunkId, promises) => {
/******/ // JSONP chunk loading for javascript
/******/ var installedChunkData = Object.prototype.hasOwnProperty.call(installedChunks, chunkId) ? installedChunks[chunkId] : undefined;
/******/ if(installedChunkData !== 0) { // 0 means "already installed".
2018-12-19 21:05:17 +08:00
/******/
2019-10-09 05:45:47 +08:00
/******/ // a Promise means "currently loading".
/******/ if(installedChunkData) {
/******/ promises.push(installedChunkData[2]);
/******/ } else {
/******/ if(true) { // all chunks have JS
/******/ // setup Promise in chunk cache
/******/ var promise = new Promise((resolve, reject) => {
/******/ installedChunkData = installedChunks[chunkId] = [resolve, reject];
/******/ });
/******/ promises.push(installedChunkData[2] = promise);
2018-12-19 21:05:17 +08:00
/******/
2019-10-09 05:45:47 +08:00
/******/ // start chunk loading
/******/ var url = __webpack_require__.p + __webpack_require__.u(chunkId);
/******/ var loadingEnded = () => {
/******/ if(Object.prototype.hasOwnProperty.call(installedChunks, chunkId) && installedChunks[chunkId]) return installedChunks[chunkId][1];
/******/ if(installedChunks[chunkId] !== 0) installedChunks[chunkId] = undefined;
/******/ };
/******/ var script = document.createElement('script');
/******/ var onScriptComplete;
2018-12-19 21:05:17 +08:00
/******/
2019-10-09 05:45:47 +08:00
/******/ script.charset = 'utf-8';
/******/ script.timeout = 120;
/******/ if (__webpack_require__.nc) {
/******/ script.setAttribute("nonce", __webpack_require__.nc);
2019-08-05 19:32:25 +08:00
/******/ }
2019-10-09 05:45:47 +08:00
/******/ script.src = url;
/******/
/******/ // 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 reportError = loadingEnded();
/******/ if(reportError) {
/******/ var errorType = event && (event.type === 'load' ? 'missing' : event.type);
/******/ var realSrc = event && event.target && event.target.src;
/******/ error.message = 'Loading chunk ' + chunkId + ' failed.\n(' + errorType + ': ' + realSrc + ')';
/******/ error.name = 'ChunkLoadError';
/******/ error.type = errorType;
/******/ error.request = realSrc;
/******/ reportError(error);
/******/ }
/******/ };
/******/ var timeout = setTimeout(function(){
/******/ onScriptComplete({ type: 'timeout', target: script });
/******/ }, 120000);
/******/ script.onerror = script.onload = onScriptComplete;
/******/ document.head.appendChild(script);
/******/ } else installedChunks[chunkId] = 0;
2018-12-19 21:05:17 +08:00
/******/
2019-10-09 05:45:47 +08:00
/******/ // no HMR
/******/ }
2018-12-19 21:05:17 +08:00
/******/ }
/******/
2019-10-09 05:45:47 +08:00
/******/ // no chunk preloading needed
2018-12-19 21:05:17 +08:00
/******/ };
/******/
/******/ // no prefetching
/******/
/******/ // no HMR
/******/
/******/ // no HMR manifest
/******/
2019-08-05 19:32:25 +08:00
/******/ // no deferred startup or startup prefetching
2018-12-19 21:05:17 +08:00
/******/
/******/ // install a JSONP callback for chunk loading
/******/ function webpackJsonpCallback(data) {
/******/ var chunkIds = data[0];
/******/ var moreModules = data[1];
/******/
/******/ var runtime = data[3];
/******/
/******/ // 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];
2019-08-05 19:32:25 +08:00
/******/ if(Object.prototype.hasOwnProperty.call(installedChunks, chunkId) && installedChunks[chunkId]) {
2018-12-19 21:05:17 +08:00
/******/ resolves.push(installedChunks[chunkId][0]);
/******/ }
/******/ installedChunks[chunkId] = 0;
/******/ }
/******/ for(moduleId in moreModules) {
/******/ if(Object.prototype.hasOwnProperty.call(moreModules, moduleId)) {
/******/ __webpack_require__.m[moduleId] = moreModules[moduleId];
/******/ }
/******/ }
/******/ if(runtime) runtime(__webpack_require__);
/******/ if(parentJsonpFunction) parentJsonpFunction(data);
/******/
/******/ while(resolves.length) {
/******/ resolves.shift()();
/******/ }
/******/
/******/ };
/******/
/******/ var jsonpArray = window["webpackJsonp"] = window["webpackJsonp"] || [];
/******/ var oldJsonpFunction = jsonpArray.push.bind(jsonpArray);
/******/ jsonpArray.push = webpackJsonpCallback;
/******/
/******/ var parentJsonpFunction = oldJsonpFunction;
/******/ }();
/******/
/******/ }
);
```
2018-12-19 21:05:17 +08:00
</details>
# Info
2017-12-14 17:58:03 +08:00
## Unoptimized
```
2017-12-14 17:58:03 +08:00
Hash: 0a1b2c3d4e5f6a7b8c9d
2019-10-09 05:45:47 +08:00
Version: webpack 5.0.0-alpha.30
2018-12-19 21:05:17 +08:00
Asset Size Chunks Chunk Names
2019-10-09 05:45:47 +08:00
548.output.js 824 bytes {548} [emitted] chunk-bar-baz2
791.output.js 824 bytes {791} [emitted] chunk-bar-baz0
930.output.js 824 bytes {930} [emitted] chunk-foo
output.js 10.4 KiB {179} [emitted] main
Entrypoint main = output.js
2019-10-09 05:45:47 +08:00
chunk {179} output.js (main) 565 bytes (javascript) 4.75 KiB (runtime) [entry] [rendered]
2019-02-05 01:52:39 +08:00
> ./example.js main
2019-05-10 03:34:28 +08:00
[0] ./example.js 405 bytes {179} [built]
2018-12-19 21:05:17 +08:00
[used exports unknown]
2019-02-05 01:52:39 +08:00
entry ./example.js main
2019-10-09 05:45:47 +08:00
[1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object 160 bytes {179} [built]
2018-12-19 21:05:17 +08:00
[used exports unknown]
import() context lazy ./templates [0] ./example.js 11:0-84
2019-10-09 05:45:47 +08:00
+ 6 hidden chunk modules
2019-05-10 03:34:28 +08:00
chunk {548} 548.output.js (chunk-bar-baz2) 38 bytes [rendered]
2019-10-09 05:45:47 +08:00
> ./baz [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz
> ./baz.js [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz.js
2019-05-10 03:34:28 +08:00
[4] ./templates/baz.js 38 bytes {548} [optional] [built]
2018-05-07 18:36:38 +08:00
[exports: default]
2018-12-19 21:05:17 +08:00
[used exports unknown]
2019-10-09 05:45:47 +08:00
context element ./baz [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz
context element ./baz.js [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz.js
2019-05-10 03:34:28 +08:00
chunk {791} 791.output.js (chunk-bar-baz0) 38 bytes [rendered]
2019-10-09 05:45:47 +08:00
> ./bar [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar
> ./bar.js [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar.js
2019-05-10 03:34:28 +08:00
[3] ./templates/bar.js 38 bytes {791} [optional] [built]
2018-05-07 18:36:38 +08:00
[exports: default]
2018-09-26 05:13:58 +08:00
[used exports unknown]
2019-10-09 05:45:47 +08:00
context element ./bar [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar
context element ./bar.js [1] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar.js
2019-05-10 03:34:28 +08:00
chunk {930} 930.output.js (chunk-foo) 38 bytes [rendered]
> ./templates/foo [0] ./example.js 1:0-62
> [0] ./example.js 5:0-8:16
[2] ./templates/foo.js 38 bytes {930} [built]
2018-12-19 18:36:59 +08:00
[exports: default]
2019-05-10 03:34:28 +08:00
[used exports unknown]
import() ./templates/foo [0] ./example.js 1:0-62
cjs require ./templates/foo [0] ./example.js 6:11-37
```
2017-12-14 17:58:03 +08:00
## Production mode
```
2017-12-14 17:58:03 +08:00
Hash: 0a1b2c3d4e5f6a7b8c9d
2019-10-09 05:45:47 +08:00
Version: webpack 5.0.0-alpha.30
2018-12-19 21:05:17 +08:00
Asset Size Chunks Chunk Names
2019-10-09 05:45:47 +08:00
548.output.js 134 bytes {548} [emitted] chunk-bar-baz2
791.output.js 134 bytes {791} [emitted] chunk-bar-baz0
930.output.js 134 bytes {930} [emitted] chunk-foo
output.js 2.32 KiB {179} [emitted] main
Entrypoint main = output.js
2019-10-09 05:45:47 +08:00
chunk {179} output.js (main) 565 bytes (javascript) 4.75 KiB (runtime) [entry] [rendered]
2019-01-25 20:15:22 +08:00
> ./example.js main
2019-05-10 03:34:28 +08:00
[144] ./example.js 405 bytes {179} [built]
2019-02-05 01:52:39 +08:00
entry ./example.js main
2019-10-09 05:45:47 +08:00
[502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object 160 bytes {179} [built]
2019-05-10 03:34:28 +08:00
import() context lazy ./templates [144] ./example.js 11:0-84
2019-10-09 05:45:47 +08:00
+ 6 hidden chunk modules
2019-05-10 03:34:28 +08:00
chunk {548} 548.output.js (chunk-bar-baz2) 38 bytes [rendered]
2019-10-09 05:45:47 +08:00
> ./baz [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz
> ./baz.js [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz.js
2019-05-10 03:34:28 +08:00
[544] ./templates/baz.js 38 bytes {548} [optional] [built]
2018-12-19 21:05:17 +08:00
[exports: default]
2019-10-09 05:45:47 +08:00
context element ./baz [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz
context element ./baz.js [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./baz.js
2019-05-10 03:34:28 +08:00
chunk {791} 791.output.js (chunk-bar-baz0) 38 bytes [rendered]
2019-10-09 05:45:47 +08:00
> ./bar [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar
> ./bar.js [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar.js
2019-05-10 03:34:28 +08:00
[398] ./templates/bar.js 38 bytes {791} [optional] [built]
2018-12-19 21:05:17 +08:00
[exports: default]
2019-10-09 05:45:47 +08:00
context element ./bar [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar
context element ./bar.js [502] ./templates lazy ^\.\/ba.*$ chunkName: chunk-bar-baz namespace object ./bar.js
2019-05-10 03:34:28 +08:00
chunk {930} 930.output.js (chunk-foo) 38 bytes [rendered]
> ./templates/foo [144] ./example.js 1:0-62
> [144] ./example.js 5:0-8:16
[718] ./templates/foo.js 38 bytes {930} [built]
2018-12-19 21:05:17 +08:00
[exports: default]
2019-05-10 03:34:28 +08:00
import() ./templates/foo [144] ./example.js 1:0-62
cjs require ./templates/foo [144] ./example.js 6:11-37
```