dev.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:3000',
    // 打开多个页面
    startUrl: ['http://localhost:3000', 'http://localhost:3000/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
TIP

建议设置在本地的 .env.local 文件中。