For AI agents: the complete documentation index is available at https://rsbuild.rs/zh/llms.txt, the full documentation bundle is available at https://rsbuild.rs/zh/llms-full.txt, and this page is available as Markdown at https://rsbuild.rs/zh/config/html/crossorigin.md.
close
  • 简体中文
  • html.crossorigin

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

    用于设置 <script> 和 <link rel="stylesheet"> 标签的 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>

    <link rel="stylesheet"> 标签变为:

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

    启用此选项后,Rsbuild 会为加载脚本和样式表文件的标签添加 crossorigin 属性,无论资源是否同源。如果标签已有该属性,则保留原值。

    可选值

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

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