本节内容派生于以下链接指向的内容 ,并遵守 CC BY 4.0 许可证的规定。
以下内容如果没有特殊声明,可以认为都是基于原内容的修改和删减后的结果。
开发服务器:该选项用于配置 @rspack/dev-server
的行为。
Object
如果当前应用没有依赖 @rspack/dev-server
,那么 devServer 配置将不会生效。
比如,Rspack CLI 默认依赖了 @rspack/dev-server
,因此在 Rspack CLI 项目里可以使用 devServer 配置。而 Rsbuild 自行实现了 dev server,并提供了单独的 "server" 配置,所以 Rsbuild 项目不能使用 devServer 配置。
string | string[] | 'all' | 'auto'
'auto'
允许访问 devServer 的白名单。
Object
'log' | 'info' | 'warn' | 'error' | 'none' | 'verbose'
'info'
客户端的日志等级。
boolean | Object
true
当发生编译错误时是否在客户端的屏幕上报错。
boolean
true
是否在客户端上显示编译进度。
boolean | number
true
开发服务器重新连接客户端的次数。true
表示不限次数。
'ws' | 'sockjs'
ws
客户端与开发服务器的传输方式。
string | object
{}
ws 服务器的 URL.
boolean
true
是否启用 gzip 压缩。
object
{}
控制 rspack-dev-middleware 的行为。
array | function | object
undefined
增加响应头。
boolean | object
false
当请求 404 页面时的兜底逻辑。
'local-ip' | 'local-ipv4' | 'local-ipv6' | string
'local-ip'
开发服务器的地址。
boolean
true
是否开启热更新。
boolean
true
是否重新加载页面。当开启 hot 时候该配置项会被关闭。
boolean
true
路径是否和产物一一对应。
function
当 devServer 与端口建立连接时的回调。
boolean | string | object | [string, object]
true
当 devServer 启动时是否打开浏览器。
'auto' | string | number
[]
用于配置端口号。
object | [object, function]
配置代理,可用于解决跨域问题等。
'http' | 'https' | 'spdy' | string | object
'http'
服务器的配置项。
function (middlewares, devServer)
自定义中间件。
boolean | string | object | [string, object]
用于配置是否从一些目录(默认为 'public')启用静态服务器。
string | object | [string, object]
监听一系列文件的变化。
false | 'sockjs' | 'ws'
用于配置 Web Socket 服务器的类型。