Want-Digest

已弃用:此功能不再推荐。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除过程中,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表格来指导您的决策。请注意,此功能可能随时停止工作。

非标准:此功能是非标准的,并且不在标准路径上。不要在面向 Web 的生产站点上使用它:它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性,并且行为可能会在将来发生变化。

注意:此标头已在草案 8中从规范中删除。请改用Want-Content-Digest。对于id-*摘要算法,请使用Want-Repr-Digest

Want-Digest请求或响应 HTTP 标头请求另一方使用Digest标头提供摘要

标头包含发送方希望服务器用来创建摘要的一个或多个摘要算法的标识符。请求可以使用质量值来指示其对特定摘要算法的偏好/顺序。

如果Want-Digest不包含服务器支持的任何摘要算法,则服务器可能会响应

  • 使用不同的摘要算法计算的摘要,或
  • 400 Bad Request错误,并在响应中包含另一个Want-Digest标头,列出其支持的算法。

另请参阅Digest标头。

标头类型 请求标头响应标头
禁止的标头名称

语法

http
Want-Digest: <digest-algorithm>

// Multiple algorithms, weighted with the quality value syntax:
Want-Digest: <digest-algorithm><q-value>,<digest-algorithm><q-value>

指令

<digest-algorithm>

摘要算法在摘要标头中定义。

  • 允许的摘要算法值包括:unixsumunixcksumcrc32csha-256sha-512id-sha-256id-sha-512
  • 已弃用的算法值包括:md5shaadler32
<q-value>

应用于该选项的质量值

示例

http
Want-Digest: sha-256
Want-Digest: SHA-512;q=0.3, sha-256;q=1, md5;q=0

基本操作

发送方提供其准备接受的摘要列表,服务器使用其中之一

请求

http
GET /item
Want-Digest: sha-256;q=0.3, sha;q=1

响应

http
HTTP/1.1 200 Ok
Digest: sha-256=X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE=

不支持的摘要

服务器不支持任何请求的摘要算法,因此使用不同的算法

请求

http
GET /item
Want-Digest: sha;q=1

响应

http
HTTP/1.1 200 Ok
Digest: sha-256=X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE=

服务器不支持任何请求的摘要算法。在这种情况下,它会响应 400 错误并包含另一个Want-Digest标头,列出其支持的算法

请求

http
GET /item
Want-Digest: sha;q=1

响应

http
HTTP/1.1 400 Bad Request
Want-Digest: sha-256, sha-512

规范

未找到规范

未找到http.headers.Want-Digest的规范数据。
检查此页面是否存在问题或为缺少的spec_url贡献内容到 mdn/browser-compat-data。还要确保规范包含在 w3c/browser-specs.

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅