api

• 类型: boolean | number | object
• 默认值: false
• 命令行终端: --api, --api.port, --api.host, --api.strictPort

监听端口并提供 API 服务，用于 UI 模式 或 浏览器服务。设为 true 时，默认端口为 51204。

api.allowWrite 4.1.0+

• 类型: boolean
• 默认值: true 表示未暴露在公共网络中，false 则表示已暴露

Vitest 服务器可以通过 API 保存测试文件或快照文件。这意味着任何能连接到 API 的人都可以在你的机器上运行任意代码。

安全警告

Vitest 默认不会将 API 暴露到互联网，仅在 localhost 上监听。但如果 host 被手动暴露到网络，任何连接到它的人都可以在你的机器上运行任意代码，除非将 api.allowWrite 和 api.allowExec 设置为false。

如果 host 设置为 localhost 或 127.0.0.1 以外的任何值，Vitest 会默认将 api.allowWrite 和 api.allowExec 设置为 false。这意味着任何写入操作（例如 在 UI 模式中修改代码）将不起作用。如果你了解安全风险，可以覆盖这些设置。

api.allowExec 4.1.0+

• 类型: boolean
• 默认值: true 表示未暴露在公共网络中，false 则表示已暴露

允许通过 API 运行任何测试文件。详细安全建议请参阅 api.allowWrite。