server.ssr

  • 类型: boolean | Object
  • 默认值: false

SSR 开关以及相关设置。

Boolean 类型

当值类型为 boolean 时,表示是否开启 SSR 部署模式,默认 false 不开启。

modern.config.ts
export default defineConfig({
  server: {
    ssr: true,
  },
});

Object 类型

当值类型为 Object 时,可以配置如下属性:

  • modestring = 'string',默认为使用 renderToString 渲染。配置为 'stream' 开启流式渲染。

  • forceCSRboolean = false,默认关闭强制 CSR 渲染。配置为 true 后,在页面访问时添加 ?csr=true 即可强制 CSR。

  • inlineScriptboolean = true,默认情况下,SSR 的数据会以内联脚本的方式注入到 HTML 中,并且直接赋值给全局变量。配置为 false 后,会下发 JSON,而不是赋值给全局变量。

modern.config.ts
export default defineConfig({
  server: {
    forceCSR: true,
    mode: 'stream',
    inlineScript: false,
  },
});