[1] ヘッダー名
(欄名)
は、ヘッダーの構文と意味を識別する名前です。
[13] 厳密にはヘッダー名はヘッダーの : より前の部分で、
: 自体はヘッダー名の一部ではありませんが、
ヘッダー名であることを明確にするため :
まで含めていることがよくあります。
[14] 例えばヘッダー Content-Type: text/plain; charset=utf-8
では Content-Type がヘッダー名です。
Content-Type: がヘッダー名とされることもあります。
仕様書
- [2] RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing ( 版) https://tools.ietf.org/html/rfc7230#page-23
- [15] OData Version 4.0 Part 1: Protocol Plus Errata 01 ( 版) http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html#_Toc393958665
- [18] UPnP Device Architecture 2.0 ( 版) http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v2.0.pdf#page=24
- [20] UPnP Device Architecture 2.0 ( 版) http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v2.0.pdf#page=48
- [92] RFC 7540 - Hypertext Transfer Protocol Version 2 (HTTP/2) ( 版) https://tools.ietf.org/html/rfc7540#section-8.1.2
- [21] RFC 7540 - Hypertext Transfer Protocol Version 2 (HTTP/2) ( 版) https://tools.ietf.org/html/rfc7540#section-10.3
構文
[3] 欄名は、字句とされています >>2。
- 字句
[8] ヘッダー名は、ASCII大文字・小文字不区別です。
[9] ヘッダーも参照。[95] HTTP/2 のヘッダーの名前としてのヘッダー名は、小文字に変換してから記述しなければなりません >>92。
文脈
[7] 次のヘッダーやキャッシュ指令には、いくつかのヘッダー名を指定できます。
- [3]
Access-Control-Allow-Headers: - [1]
Access-Control-Expose-Headers: - [4]
Access-Control-Request-Headers: - [2]
Connection: - [6]
Vary: Variant-Vary:- [5]
Cache-Control: no-cache Cache-Control: private- 拡張宣言
処理
[96] 構文上認められないヘッダー名 >>101 や大文字のヘッダー名 >>92
を含むメッセージは、奇形です。
[22] HTTP/2 ヘッダー名に構文上認められない文字が含まれている場合、
メッセージは奇形です >>21。
[96] HTTP/2 ヘッダー名に大文字が含まれている場合、
メッセージは奇形です >>92。
[23] 実際には Chrome は大文字を除く任意のバイトの0個以上の列を奇形でないと判断するようです。
(少なくても XHR では) その先頭と末尾の空白は、除去します。
名前が空バイト列のヘッダーは、無視します。
[24] Firefox は大文字を除く任意のバイトの0個以上の列を奇形でないと判断するようです。
(少なくても XHR では) 名前が字句でないヘッダーは、無視します。
(ただし名前に : が含まれるヘッダーの扱いは奇妙です。)
[25] Chrome も Firefox も、字句でなく大文字を含む場合、
奇形として扱います。
予約されているヘッダー名
[12] X- から始まるヘッダー名についての規定は RFC 723x
世代から無くなっています。 (X-* を参照。)
[17] RFC 2774 は2桁以上の ASCII数字と -
から始まるヘッダー名を同仕様に基づく拡張で使っています。
ヘッダー接頭辞参照。[19] SSDP >>18 および UPnP における HTTP >>20
は vendor 独自のヘッダー名として
. と Vendor Domain Name で終わるドメイン名型の字句を使うことを認めています。
- 字句
.- Vendor Domain Name
[16] OData は、 OData の実装に対して OData
から始まる (OData で規定されていない) ヘッダーの利用を禁止しています >>15。
ヘッダーの一覧
[10] HTTPヘッダーの一覧を参照。
[11] IANA登録簿についてはHTTPヘッダーを参照。
歴史
[26] Stop lowercasing header names
(annevk著, )
https://github.com/whatwg/fetch/commit/5869c43a27fff06c6dfc228fe1288018f7f2168d
[27] Adjust CORS wildcard handling slightly
(annevk著, )
https://github.com/whatwg/fetch/commit/358dbf5296d91bb791d864b677b367bb11b3bf37
[28] Field-name syntax · Issue #30 · httpwg/http11bis
()
https://github.com/httpwg/http11bis/issues/30
[29] Casing of client headers is maybe not accurate · Issue #475 · whatwg/fetch
()
https://github.com/whatwg/fetch/issues/475
[30] Editorial: defining header name sorting by annevk · Pull Request #906 · whatwg/fetch
()
https://github.com/whatwg/fetch/pull/906