server.cors

  • 类型: boolean | import('cors').CorsOptions
  • 默认值: true
  • 版本: >= 1.1.11

为开发服务器和预览服务器配置 CORS 选项,基于 cors 中间件实现。

  • true:启用 CORS 并使用默认选项。
  • false:禁用 CORS。
  • object:启用 CORS 并使用指定的选项。

示例

仅为开发服务器启用 CORS:

export default {
  server: {
    cors: process.env.NODE_ENV === 'development',
  },
};

禁用 CORS:

export default {
  server: {
    cors: false,
  },
};

选项

cors 选项可以是一个对象,与 cors 中间件的选项相同。

默认配置等同于:

const defaultCorsOptions = {
  origin: '*',
  methods: 'GET,HEAD,PUT,PATCH,POST,DELETE',
  preflightContinue: false,
  optionsSuccessStatus: 204,
};

例如,使用 origin 选项配置 Access-Control-Allow-Origin 头:

export default {
  server: {
    cors: {
      origin: 'https://example.com',
    },
  },
};