startUrl
- 类型:
boolean | string | string[] | undefined
- 默认值:
undefined
dev.startUrl
用于设置 Server 启动时自动在浏览器中打开的页面 URL。
默认情况下,当 dev server 或 preview server 启动时,不会自动打开任何页面,你可以通过 dev.startUrl
或 CLI 的 --open
参数来设置自动打开页面。
示例
你可以设置为如下的值:
export default {
dev: {
// 打开项目的默认页面,等价于 `http://localhost:<port>`
startUrl: true,
// 打开指定的页面
startUrl: 'http://localhost:8080',
// 打开多个页面
startUrl: ['http://localhost:8080', 'http://localhost:8080/about'],
},
};
端口号占位符
由于端口号可能会发生变动,你可以使用 <port>
占位符来指代当前端口号,Rsbuild 会自动将占位符替换为实际监听的端口号。
export default {
dev: {
startUrl: 'http://localhost:<port>/home',
},
};
打开指定浏览器
在 MacOS 上,通过设置环境变量 BROWSER
,你可以指定 Dev Server 在启动时打开的浏览器,支持如下的值:
- Google Chrome Canary
- Google Chrome Dev
- Google Chrome Beta
- Google Chrome
- Microsoft Edge
- Brave Browser
- Vivaldi
- Chromium