大网数据广告活动
Web 标准与前端开发

HTML 属性:crossorigin

· 52CE 我爱测

**`crossorigin`** 属性在 audio、img、link、script 和 video 元素中有效,它们提供对 CORS 的支持,定义该元素如何处理跨源请求,从而实现对该元素获取数据的 CORS 请求的配置。根据元素的不同,该属性可以是一个 CORS 设置属性。

crossorigin 属性在 audio、img、link、script 和 video 元素中有效,它们提供对 CORS 的支持,定义该元素如何处理跨源请求,从而实现对该元素获取数据的 CORS 请求的配置。根据元素的不同,该属性可以是一个 CORS 设置属性。

在媒体元素上所使用的 crossorigin 内容属性为 CORS 设置属性。

这些属性是枚举的,并具有以下可能的值:

  • anonymous
    • : 请求使用了 CORS 标头,且证书标志被设置为 'same-origin'。没有通过 cookies、客户端 SSL 证书或 HTTP 认证交换用户凭据,除非目的地是同一来源。
  • use-credentials
    • : 请求使用了 CORS 标头,且证书标志被设置为 'include'。总是包含用户凭据。
  • ""
    • : 将属性名称设置为空值,如 crossorigin 或 crossorigin="",与设置为 anonymous 的效果一样。

不合法的关键字或空字符串会视为 anonymous 关键字。

默认情况下(即未指定该属性时),CORS 根本不会使用。用户代理不会要求对资源进行完全访问的许可,在跨源请求的情况下,将根据相关元素的类型进行某些限制:

<table class="no-markdown"> <tbody> <tr> <td class="header">元素</td> <td class="header">限制</td> </tr> <tr> <td><code>img</code>、<code>audio</code>、<code>video</code></td> <td> 当资源被放置在 canvas 中时,元素会标记为<a href="/zh-CN/docs/Web/HTML/How_to/CORS_enabled_image#安全性和“被污染”的_canvas"><em>被污染的</em></a>。 </td> </tr> <tr> <td><code>script</code></td> <td> 对错误日志 Window.error_event 的访问将会被限制。 </td> </tr> <tr> <td><code>link</code></td> <td> 使用了不合适的 <code>crossorigin</code> 标头的请求可能会被丢弃。 </td> </tr> </tbody> </table>

[!NOTE] 在 Firefox 83 版本之前,rel="icon" 元素不支持 crossorigin 属性。也有一个 Chrome 的未解决的议题。

示例:使用 crossorigin 的 <script> 元素

你可以使用下面的 script 元素告诉浏览器执行来自 https://example.com/example-framework.js 的脚本且不发送用户凭据。

<script
  src="https://example.com/example-framework.js"
  crossorigin="anonymous"></script>

示例:带有用户凭据的 Web 清单

在获取需要用户凭据的清单时,即使是同源的情况,属性值也必须设置为 use-credentials。

<link rel="manifest" href="/app.webmanifest" crossorigin="use-credentials" />

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。