webpack学习配置笔记(二)

2017-12-04  本文已影响194人  雨飞飞雨

千里之行,始于足下!

模块热替换

模块热替换(Hot Module Replacement 或 HMR)是 webpack 提供的最有用的功能之一。它允许在运行时更新各种模块,而无需进行完全刷新。

HMR 不适用于生产环境,这意味着它应当只在开发环境使用。更多详细信息,请查看生产环境构建指南。

启用HMR

启动这个功能我们只需要更新一下webpack-dev-server的配置就可以了。

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const CleanWebpackPlugin = require('clean-webpack-plugin');
const webpack = require('webpack');
module.exports = {
    // entry: './src/index.js',
    entry:{
        // app:'./src/index.js',
        // print:'./src/print.js'
        app: './src/index.js'
    },
    output: {
        // filename: 'bundle.js',
        filename:'[name].bundle.js',
        path: path.resolve(__dirname, 'dist'),
        publicPath:'/'
    },
    module:{
        rules:[
            ...
        ]
    },
    plugins:[
        new CleanWebpackPlugin(['dist']),//清理的文件夹
        new HtmlWebpackPlugin({
            title:'Output Management'
        }),
        new webpack.NamedModulesPlugin(),
        new webpack.HotModuleReplacementPlugin()
    ],
    devtool:'inline-source-map',
    devServer:{
        contentBase:'./dist',
        hot: true
    }
};

其中我们添加了两个webpack的插件,NamedModulePluginHotModuleReplacementPluginNamedModulePlugin可以更容易查看要修补的(patch)的依赖,
然后通过npm start 命令来启动并运行dev server.

现在,我们来修改 index.js 文件,以便当 print.js 内部发生变更时可以告诉 webpack 接受更新的模块。

import _ from 'lodash';
import './style.css';
import printMe from './print';
function component() {
    var element = document.createElement('div');
    var btn = document.createElement('button');
    element.innerHTML = _.join(['Hello', 'webpack'], ' ');
    btn.innerHTML = 'Click Me and check the console!';
    btn.onclick = printMe;
    element.appendChild(btn);
    return element;
}

document.body.appendChild(component());
//添加的部分
if (module.hot) {
    module.hot.accept('./print.js', function () {
        console.log('Accepting the updated printMe module!');
        printMe();
    })
}

更改print.js文件中的输出内容。

console.log('Updating print.js...')

我们看一下console

Hash: 0fa02a6e57bd19fe1c28
Version: webpack 3.9.1
Time: 753ms
                               Asset       Size  Chunks                    Chunk Names
e18f911935d945f7f5b0.hot-update.json   44 bytes          [emitted]         
                       app.bundle.js    2.39 MB       0  [emitted]  [big]  app
0.38e076a538bfd3d7f51e.hot-update.js    1.05 kB       0  [emitted]         app
38e076a538bfd3d7f51e.hot-update.json   43 bytes          [emitted]         
                          index.html  193 bytes          [emitted]         
[./node_modules/webpack/hot ^\.\/log$] ./node_modules/webpack/hot nonrecursive ^\.\/log$ 170 bytes {0} [built]
[./src/print.js] ./src/print.js 128 bytes {0} [built]
    + 33 hidden modules
Child html-webpack-plugin for "index.html":
                                   Asset      Size  Chunks             Chunk Names
    e18f911935d945f7f5b0.hot-update.json  44 bytes          [emitted]  
     + 1 hidden asset
       4 modules
webpack: Compiled successfully.

通过 Node.js API

当使用 webpack dev server 和 Node.js API 时,不要将 dev server 选项放在 webpack 配置对象(webpack config object)中。而是,在创建选项时,将其作为第二个参数传递。例如:

new WebpackDevServer(compiler, options)

想要启用 HMR,还需要修改 webpack 配置对象,使其包含 HMR 入口起点。webpack-dev-server package 中具有一个叫做 addDevServerEntrypoints 的方法,你可以通过使用这个方法来实现。这是关于如何使用的一个小例子:

dev-server.js

const webpackDevServer = require('webpack-dev-server');
const webpack = require('webpack');

const config = require('./webpack.config.js');
const options = {
  contentBase: './dist',
  hot: true,
  host: 'localhost'
};

webpackDevServer.addDevServerEntrypoints(config, options);
const compiler = webpack(config);
const server = new webpackDevServer(compiler, options);

server.listen(5000, 'localhost', () => {
  console.log('dev server listening on port 5000');
});

详情请看:模块热更新

Tree Shaking

tree shaking 是一个术语,通常用于描述移除 JavaScript 上下文中的未引用代码(dead-code)。它依赖于 ES2015 模块系统中的静态结构特性,例如 import 和 export。这个术语和概念实际上是兴起于 ES2015 模块打包工具 rollup。就是在打包的时候精简代码的。

现在我们试一下,首先我们添加一个通用模块。在项目中添加src/math.js,添加两个导出的函数。

/**
 * Created by jfy on 2017/12/4.
 * 千里之行,始于足下!
 */

export function square(x) {
    return x * x;
}

export function cube(x) {
    return x * x * x;
}

接着更新入口,使用其中的一个新方法,并且为了简单,我们把lodash删除:
src/index.js

import './style.css';
import printMe from './print';
import {cube} from './math.js';
function component() {
   
    var element = document.createElement('pre');

    element.innerHTML = ['Hello webpack!','5 cubed is qeual to '+cube(5)].join('\n\n');
    return element;
}

document.body.appendChild(component());

注意,我们并未从 src/math.js 模块中 import 导入 square 方法。这个功能是所谓的“未引用代码(dead code)”,也就是说,应该删除掉未被引用的 export。现在让我们运行我们的npm 脚本 npm run build,并检查输出的 bundle:

/* 1 */
/***/ (function(module, __webpack_exports__, __webpack_require__) {

"use strict";
/* unused harmony export square */
/* harmony export (immutable) */ __webpack_exports__["a"] = cube;
function square(x) {
  return x * x;
}

function cube(x) {
  return x * x * x;
}

精简输出

我们已经通过 import and export 语法,标识出了那些“未引用代码(dead code)”,但是我们仍然需要从 bundle 中删除它们。要做到这一点,我们将添加一个能够删除未引用代码(dead code)的压缩工具(minifier) - UglifyJSPlugin - 在配置对象中添加……

npm i --save-dev uglifyjs-webpack-plugin

然后将其添加到我们的配置中:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const CleanWebpackPlugin = require('clean-webpack-plugin');
const webpack = require('webpack');
+ const UglifyJSPlugin = require('Uglifyjs-webpack-plugin');
module.exports = {
    // entry: './src/index.js',
    entry:{
        // app:'./src/index.js',
        // print:'./src/print.js'
        app: './src/index.js'
    },
    output: {
        // filename: 'bundle.js',
        filename:'[name].bundle.js',
        path: path.resolve(__dirname, 'dist'),
        publicPath:'/'
    },
    module:{
        rules:[
            ...
        ]
    },
    plugins:[
        new CleanWebpackPlugin(['dist']),//清理的文件夹
        new HtmlWebpackPlugin({
            title:'Output Management'
        }),
        new webpack.NamedModulesPlugin(),
        new webpack.HotModuleReplacementPlugin(),
+       new UglifyJSPlugin()
    ],
    devtool:'inline-source-map',
    devServer:{
        contentBase:'./dist',
        hot: true
    }
};

准备就绪后,然后运行另一个命令 npm run build,看看输出结果有没有发生改变。

你发现 dist/bundle.js 中的差异了吗?显然,现在整个 bundle 都已经被精简过,但是如果仔细观察,则不会看到 square 函数被引入,但会看到 cube 函数的修改版本(function r(e){return eee}n.a=r)。现在,随着 tree shaking 和代码压缩,我们的 bundle 减小几个字节!虽然,在这个特定示例中,可能看起来没有减少很多,但是,在具有复杂的依赖树的大型应用程序上运行时,tree shaking 或许会对 bundle 产生显著的体积优化。

警告

请注意,webpack 本身并不会执行 tree-shaking。它需要依赖于像 UglifyJS 这样的第三方工具来执行实际的未引用代码(dead code)删除工作。有些情况下,tree-shaking 可能不会生效。例如,考虑以下模块:

transforms.js

import * as mylib from 'mylib';

export const someVar = mylib.transform({
  // ...
});

export const someOtherVar = mylib.transform({
  // ...
});

index.js

mport { someVar } from './transforms.js';

// 使用 `someVar`...

在上面的代码中,webpack 不能确定是否调用 mylib.transform 会引发任何副作用(side-effects)。因此,为保险起见,将在 bundle 代码中保留 someOtherVar。

一般来说,当一个工具不能保证某些特定的代码路径(path)不会导致副作用(side-effects)时,即使你确信它不应该存在生成的 bundle 中,但这个代码仍然会保留。常见的情况有:从第三方模块中调用一个函数,webpack 和/或 压缩工具(minifier)无法检查此模块;从第三方模块导入的函数被重新导出,等等。

本指南中使用的代码假设你使用 UglifyJS 插件来执行 tree-shaking。然而,还有其他工具,如 webpack-rollup-loaderBabel Minify Webpack Plugin,根据你的设置它们可能产生不同的结果。

结论

为了学会使用 tree shaking,你必须……

使用 ES2015 模块语法(即 import 和 export)。
引入一个能够删除未引用代码(dead code)的压缩工具(minifier)(例如 UglifyJSPlugin)。
你可以将应用程序想象成一棵树。绿色表示实际用到的源码和 library,是树上活的树叶。灰色表示无用的代码,是秋天树上枯萎的树叶。为了除去死去的树叶,你必须摇动这棵树,使它们落下。

上一篇下一篇

猜你喜欢

热点阅读