html.crossorigin

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

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

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

示例

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",并始终包含用户凭据。