DPR header

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

警告:DPR header 已从客户端提示规范的 draft-ietf-httpbis-client-hints-07 中移除。建议的替代方案是 Sec-CH-DPR (响应式图片客户端提示)。

HTTP DPR 请求头提供了关于客户端设备像素比(DPR)的设备客户端提示。此比例是对应于每个CSS 像素的物理设备像素数量。

此提示在选择最符合屏幕像素密度的图像源时非常有用。这类似于 <img> srcset 属性中 x 描述符所扮演的角色,允许用户代理选择首选图像。

如果服务器使用 DPR 提示选择在响应中发送的资源,则响应必须包含 Content-DPR 头。如果 Content-DPR 中的值与请求的 DPR 头中的值不同,客户端必须使用 Content-DPR 中的值进行布局。如果 DPR 头在消息中出现多次,则使用最后一次出现的值。

选择接收 DPR 客户端提示的服务器通常也会在 Vary 头中指定它,以告知缓存服务器可能会根据请求中的头值发送不同的响应。

头类型 请求标头客户端提示
禁止请求头

语法

http
DPR: <number>

指令

<number>

客户端设备像素比。

示例

服务器必须首先通过发送包含 DPR 指令的响应头 Accept-CH 来选择接收 DPR 头。

http
Accept-CH: DPR

然后在后续请求中,客户端可能会将 DPR 头发送到服务器

http
DPR: 2.0

如果带有 DPR 头(如上所示)的请求是针对图像资源的,则服务器响应必须包含 Content-DPR

http
Content-DPR: 2.0

浏览器兼容性

另见