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
|