Skip to content

browser.api

  • 类型: number | object
  • 默认值: 63315
  • CLI: --browser.api=63315, --browser.api.port=1234, --browser.api.host=example.com

该配置用于在浏览器中提供代码的 Vite 服务器选项。不会影响 test.api 选项。默认情况下,Vitest 会分配端口 63315 以避免与开发服务器冲突,从而允许你并行运行两者。

api.allowWrite 4.1.0+

  • 类型: boolean
  • 默认值: 如果不暴露给网络则为 true,否则为 false

Vitest 通过接收来自浏览器的 WebSocket 连接来保存注解附件产物快照。这允许任何能够连接到 API 的人,在你的项目根目录内(由 fs.allow 配置)向你的机器写入任意代码。此选项还会限制那些可以间接写入文件的受特权浏览器 API,例如通过 cdp() 直接访问 Chrome DevTools Protocol。

如果浏览器服务器未暴露给互联网(主机为 localhost),这应该不是问题,因此这种情况下的默认值为 true。如果你覆盖了主机,Vitest 默认会将 allowWrite 设置为 false,以防止潜在有害的写入。

api.allowExec 4.1.0+

  • 类型: boolean
  • 默认值: 如果不暴露给网络则为 true,否则为 false

允许通过 UI 运行任何测试文件。这适用于 UI 中可以运行代码的交互式元素(以及其背后的服务器代码)。此选项还会限制那些可以间接执行代码的受特权浏览器 API,例如通过 cdp() 直接访问 Chrome DevTools Protocol。更多信息请参见 api.allowExec