10 Webpack中的配置-DevServer

DevServer

DevServer在Webpack中使用的非常普遍,通过在本地搭建一个Express服务,对项目进行部署运行的方式,来增强项目开发过程中的调试。要启用DevServer需要安装Webpack-dev-server依赖模块。DevServer有着很多丰富的配置,可以满足大多数场景。通过运行webpack-dev-server命令即可使用DevServer,其默认读取的服务配置和Webpack默认的配置文件一样都是webpack.config.js,可以使用webpack-dev-server --config file_path命令来指定服务配置文件的路径。

ContentBase

本地服务成功运行的时候,会根据ContentBase的值作为服务器的文件根目录去读取和加载资源,其默认为当前的执行目录:

const path = require("path");
module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        contentBase: path.join(__dirname, "dist"),
    }
}

Compress

Compress用于配置服务是否采用Gzip压缩,其值类型为Boolean类型,默认false:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        compress: true,
    }
}

Port

Port表明了服务运行时的监听端口,默认是8080。如果8080端口被占用就会使用8081端口,以此类推:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        port: 8083
    }
}

Host

Host指定了服务器监听的地址,默认为127.0.0.1。如果想在同一局域网的设备访问该服务,需要配置成0.0.0.0:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        host: "0.0.0.0"
    }
}

Hot

DevServer的默认行为是在源码修改之后通过刷新整个页面来实现实时预览,当设置Hot为true的时候,开启了模块热替换,当源码发生改变之后,在不刷新页面的情况下使用新模块替换老模块实现实时预览:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        hot: true
    }
}

HistoryApiFallback

当开发单页应用时,如果使用 HTML5 History API来控制路由的切换,不同的路由需要请求一个新的视图(view)显示在同一个HTML页面上。默认情况下,路由切换发送的资源请求会导致404错误。HistoryApiFallback的作用就是在你切换路由的时候都返回index.html文件资源,避免产生资源加载错误:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        historyApiFallback: true,
    },
}

开发多页面时候的时,为确保每一个路由返回一个不同的HTML文件,通过传入一个对象,使用Rewrites选项,来精细化控制路由对应资源的加载:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        historyApiFallback: {
    
    
            rewrites: [
                {
    
     from: /^\/$/, to: '/views/landing.html' },
                {
    
     from: /^\/subpage/, to: '/views/subpage.html' },
                {
    
     from: /./, to: '/views/404.html' }
            ]
        }
    },
}

Open

Open表示在运行服务器的时候,是否需要自动打开默认浏览器,默认为false,设置为true后,启动服务就会自动打开浏览器加载相关资源进行显示:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        open: true
    },
}

命令webpack-dev-server --open和该配置功能一样,使用openPage可以加载指定路径的页面。

Https

DevServer默认使用的是Http服务,有些时候必须使用Https服务,例如使用Service Worker(service worker原则上只能在Https服务下使用,为了支持本地调试,在localhost服务也可以使用),也可以搭建一个本地Https服务:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        https: true,
    },

}

以上设置使用了内置的自签名证书,可以提供自己的签名证书:

module.exports = {
    
    
    /* 其他配置 */
    devServer: {
    
    
        https: {
    
    
            key: fs.readFileSync("/path/to/server.key"),
            cert: fs.readFileSync("/path/to/server.crt"),
            ca: fs.readFileSync("/path/to/ca.pem"),
        }
    },
}

本章节提供案例源码下载:https://gitee.com/mvc_ydb/webpack/blob/master/devServer.zip

猜你喜欢

转载自blog.csdn.net/sinat_41212418/article/details/121549323