close
  • 简体中文

      • html.crossorigin

      • 类型： boolean | 'anonymous' | 'use-credentials'
      • 默认值： false

      用于设置 <script> 和 <style> 标签的 crossorigin 属性。

      • 当传入 true 时，它会被自动设置为 crossorigin="anonymous"。
      • 当传入 false 时，它不会设置 crossorigin 属性。

      示例

      rsbuild.config.ts
      export default {
  html: {
    crossorigin: 'anonymous',
  },
  output: {
    assetPrefix: 'https://example.com',
  },
};

      构建后，HTML 中的 <script> 标签变为：

      <script defer src="https://example.com/static/js/main.js" crossorigin="anonymous"></script>

      <style> 标签变为：

      <link href="https://example.com/static/css/main.css" rel="stylesheet" crossorigin="anonymous" />
      Tip

      如果静态资源的域名和当前页面的域名一致，那么 Rsbuild 将不会添加 crossorigin="anonymous" 属性，因为非跨域情况下不需要此属性。

      可选值

      crossorigin 可以被设置为以下几个值：

      • anonymous：请求使用 CORS 头，并将证书标志设置为 "same-origin"。除非目标是相同的 origin，否则不会通过 cookie、客户端 SSL 证书或 HTTP 身份验证交换用户凭据。
      • use-credentials：请求使用 CORS 头，证书标志设置为 "include"，并始终包含用户凭据。