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