1. 面向开发者的 Web 技术
  2. HTTP
  3. 参考
  4. HTTP 标头
  5. Sec-Fetch-Dest

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Sec-Fetch-Dest

基线 广泛可用 *

自 2023年3月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Want more browser support for this feature? Tell us why.

* 此特性的某些部分的支持程度可能有所不同。

Sec-Fetch-Dest Fetch 元数据请求标头指示请求的目标，即数据的来源以及如何使用这些获取到的数据。

这允许服务器根据请求是否采用了适当的使用方式来确定是否为请求提供服务。例如，具有 audio 目标的请求应请求音频数据，而不是其他类型的资源（例如，包含敏感用户信息的文档）。

标头类型 Fetch 元数据请求标头
禁止修改的消息首部 是（带有 Sec- 前缀）
CORS-safelisted request header 否

语法

http
Sec-Fetch-Dest: audio
Sec-Fetch-Dest: audioworklet
Sec-Fetch-Dest: document
Sec-Fetch-Dest: embed
Sec-Fetch-Dest: empty
Sec-Fetch-Dest: font
Sec-Fetch-Dest: frame
Sec-Fetch-Dest: iframe
Sec-Fetch-Dest: image
Sec-Fetch-Dest: manifest
Sec-Fetch-Dest: object
Sec-Fetch-Dest: paintworklet
Sec-Fetch-Dest: report
Sec-Fetch-Dest: script
Sec-Fetch-Dest: serviceworker
Sec-Fetch-Dest: sharedworker
Sec-Fetch-Dest: style
Sec-Fetch-Dest: track
Sec-Fetch-Dest: video
Sec-Fetch-Dest: worker
Sec-Fetch-Dest: xslt

如果此标头包含任何其他的值，服务器应忽略它。

指令

备注：这些指令对应于 Request.destination 返回的值。

audio

目标是音频数据。这可能源自 HTML <audio> 标签。

audioworklet

目标是获取供 audio worklet 使用的数据。这可能源于对 audioWorklet.addModule() 的调用。

document

目标是文档（HTML 或 XML），请求是用户发起的顶级导航的结果（例如，由用户单击链接产生）。

embed

目标是嵌入内容。这可能源自 HTML <embed> 标签。

empty

目标是空字符串。这用于没有自己值的目标。例如：fetch()、navigator.sendBeacon()、EventSource、XMLHttpRequest、WebSocket 等等。

font

目标是字体。这可能源自 CSS @font-face。

frame

目标是 frame。这可能源自 HTML <frame> 标签。

iframe

目标是 iframe。这可能源自 HTML <iframe> 标签。

image

目标是图片。这可能源自 HTML <image>、SVG <image>、CSS background-image、CSS cursor、CSS list-style-image 等等。

manifest

目标是 mainfest。这可能源自 HTML <link rel=manifest>。

object

目标是对象，这可能源自 <object> 标签。

paintworklet

目标是 paint worklet。这可能源自对 CSS.PaintWorklet.addModule() 的调用。

report

目标是报告（如一份内容安全策略报告）。

script

目标是一个脚本。这可能源自 HTML <script> 标签或对 WorkerGlobalScope.importScripts() 的调用。

serviceworker

目标是 service worker。这可能源于对 navigator.serviceWorker.register() 的调用。

sharedworker

目标是 shared worker。这可能源自 SharedWorker。

style

目标是 style。这可能源自 HTML <link rel=stylesheet> 或者 CSS @import。

track

目标是 HTML text track。这可能源自 HTML <track> 标签。

video

目标是视频数据。这可能源自于 <video> 标签。

worker

目标是 Worker。

xslt

目标是 XSLT 转换。

示例

<img> 元素生成的跨域请求将具有以下的 HTTP 请求标头（请注意，目标是 image）：

http
Sec-Fetch-Dest: image
Sec-Fetch-Mode: no-cors
Sec-Fetch-Site: cross-site

规范

规范
Fetch Metadata Request Headers
# sec-fetch-dest-header

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题