[4] [DFN[[RUBYB[[[ホスト]]]@en[host]]]]は、[[ドメイン名]]または[[IPアドレス]]です。 * 仕様書 [REFS[ - [2] '''[CITE@en[URL Standard]] ([TIME[2015-09-18 15:38:29 +09:00]] 版) ''' - [30] [CITE@en[URL Standard]] ([TIME[2016-08-25 16:02:43 +09:00]]) - [161] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2016-03-31 07:16:44 +09:00]] 版) - [11] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2016-03-14 22:44:13 +09:00]] 版) ]REFS] * 意味 [3] [DFN[[RUBYB[[[ホスト]]]@en[host]]]]は、[[ドメイン]]、[[IPv4アドレス]]、[[IPv6アドレス]]、 [[不透明ホスト]]、[[空ホスト]]のいずれかです [SRC[>>2]]。 [FIG(railroad)[ = | == [[ドメイン]] == [[IPv4アドレス]] == [[IPv6アドレス]] == [[不透明ホスト]] == [[空ホスト]] ]FIG] [5] 普通は[[ホスト]]は[[ネットワークアドレス]]となりますが、 時たま[[ネットワークアドレス]]が不要な場面の [[URL]] において[[不透明]]な[[識別子]]として利用 (濫用) されます。 [SRC[>>2]] * 文脈 [162] [[項組起源]]の [DFN[[F[ホスト]]]] [SRC[>>161]] は、 [[起源]]のうちの[[ホスト]]の部分を表しています。 ;; [[項組起源]]参照。 * 構文解析 [29] [DFN[[RUBYB[ホスト構文解析器]@en[host parser]]]]は、 [[文字列]][VAR[入力]]と[VAR[[[非特殊]]]] (既定値[[偽]]) について、次のようにします [SRC[>>30]]。 [FIG(steps)[ = [33] [VAR[入力]]の先頭が [CODE[U+005B]] の場合、 == [34] [VAR[入力]]の末尾が [CODE[U+005D]] でなければ、 === [35] [[構文違反]]です。 === [36] [[失敗]]を返し、ここで停止します。 == [38] [VAR[入力]]の先頭と末尾の[[文字]]を除去します。 == [37] [VAR[入力]]に [[IPv6構文解析器]]を適用した結果を返し、ここで停止します。 = [57] [VAR[非特殊]]が[[真]]の場合、 == [58] [VAR[入力]]に[[不透明ホスト構文解析器]]を適用した結果を返し、 ここで停止します。 = [39] [VAR[ドメイン]]を、[VAR[入力]]を[[文字列パーセント復号]]し、 [[BOMなしUTF-8復号]]した結果に設定します。 = [40] [VAR[ASCIIドメイン]]を、 [VAR[ドメイン]]に[[ドメインをASCIIに]]を適用した結果に設定します。 = [41] [VAR[ASCIIドメイン]]が[[失敗]]なら、 == [42] [[失敗]]を返し、ここで停止します。 = [43] [VAR[ASCIIドメイン]]に次のいずれかが含まれる場合、 [FIG(list short)[ - [CODE[U+0000]] - [CODE[U+0009]] - [CODE[U+000A]] - [CODE[U+000D]] - [CODE[U+0020]] - [CODE[#]] - [CODE[%]] - [CODE[/]] - [CODE[:]] - [CODE[?]] - [CODE[@]] - [CODE[U+005B]] - [CODE[U+005C]] - [CODE[U+005D]] ]FIG] == [44] [[構文違反]]とします。 == [45] [[失敗]]を返し、ここで停止します。 = [46] [VAR[IPv4ホスト]]を、[VAR[ASCIIドメイン]]に [[IPv4構文解析器]]を適用した結果に設定します。 = [49] [VAR[IPv4ホスト]]により、 [FIG(switch)[ : [[失敗]] : [[失敗]]を返します。 : [[IPv4アドレス]] : [VAR[IPv4ホスト]]を返します。 : [[ドメイン]] : [VAR[ASCIIドメイン]]を返します。 ]FIG] ]FIG] [31] 次の場面で呼び出されます。 [FIG(short list)[ - [[URL構文解析器]] - [CODE(JS)@en[document.domain]] - [[登録可能ドメイン接尾辞であるか等しい]] - [CODE[no_proxy]] ([[Web Transport Processing]]) [HISTORY[ - [CODE(DOMm)@en[domainToASCII]] - [CODE(DOMm)@en[domainToUnicode]] ]HISTORY] ]FIG] * API [7] [CODE(DOMi)@en[[[URLUtils]]]] [[インターフェイス]]の [DFN[[CODE(DOMa)@en[[[hostname]]]]]] [[IDL属性]] [SRC[>>8]] は、[[ホスト]]を表します。 ;; [9] [CODE(DOMa)@en[[[host]]]] [[IDL属性]]は、[[ホスト]]と[[ポート]]を表します。 ** 性質 [20] この[[属性]]は、 [CODE(xattr IDL)@en[Unforgeable]] です [SRC[>>11]]。 ** 取得器 [16] [CODE(JS)@en[location.hostname]] の[[取得器]]は、次のようにしなければ[MUST[なりません]] [SRC[>>11]]。 [FIG(steps)[ = [24] [[文脈オブジェクト]]の[F[[[関係する[CODE(DOMi)@en[Document]]]]]]の[F[起源][文書の起源]]と[[入口設定群オブジェクト]]の[F[起源]]が[[同じ起源ドメイン]]でなければ、 == [25] [CODE(DOMe)@en[SecurityError]] [[例外]]を[[投げ]]、ここで停止します。 = [26] [VAR[URL]]の[F[ホスト]]が [[null]] なら、 == [27] [[空文字列]]を返してここで停止します。 = [28] [VAR[URL]]の[F[ホスト]]に[[ホスト直列化器]]を適用した結果を返します。 ]FIG] ** 設定器 [12] [CODE(JS)@en[location.hostname]] の[[設定器]]は、次のようにしなければ[MUST[なりません]] [SRC[>>11]]。 [FIG(steps)[ = [21] [VAR[入力]]を、与えられた値を [CODE(IDL)@en[USVString]] として解釈した結果に設定します。 = [13] [[文脈オブジェクト]]の[F[[[関係する[CODE(DOMi)@en[Document]]]]]]の[F[起源][文書の起源]]と[[入口設定群オブジェクト]]の[F[起源]]が[[同じ起源ドメイン]]でなければ、 == [14] [CODE(DOMe)@en[SecurityError]] [[例外]]を[[投げ]]、ここで停止します。 = [15] [VAR[複製]]を、[[文脈オブジェクト]]の[F[URL][Location (DOM)]] に設定します。 = [17] [VAR[複製]]の[F[cannot-be-a-base-URL flag]]が設定されていれば、ここで停止します。 = [18] [VAR[入力]]に[[基本URL構文解析]]を適用します。 [VAR[URL]] は[VAR[複製]]、[VAR[状態上書き]]は [[hostname state]] とします。 = [19] [[文脈オブジェクト]]と [VAR[複製]]について [[[CODE(DOMi)@en[Location]]-object-setter navigate]] を実行します。 ]FIG] * 関連 [6] 「[[ホスト]]」と「[[ドメイン]]」の用語の混乱については、[[ドメイン名]]を参照。 [1] [[authority]] も参照。 * 歴史 [10] [CITE@en[Be clear about the initial value of the Unicode flag. Fixes https://w… · whatwg/url@468be05]] ([TIME[2015-06-16 15:06:42 +09:00]] 版) [REFS[ - [8] [CITE@en[URL Standard]] ([TIME[2015-09-18 15:38:29 +09:00]] 版) ]REFS] [22] [CITE@en[Editorial: non-relative flag got renamed · whatwg/html@d360c27]] ([TIME[2016-03-31 12:40:27 +09:00]] 版) [23] [CITE@en[Merge effective script origin into origin · whatwg/html@8a843f2]] ([TIME[2016-03-31 18:07:53 +09:00]] 版) [52] [CITE@en[Editorial: cleanup host similarly to URL]] ([[annevk]]著, [TIME[2016-11-01 00:18:24 +09:00]]) [53] [CITE@en[Add opaque hosts]] ([[annevk]]著, [TIME[2017-01-25 04:51:54 +09:00]]) [54] [CITE@en[Editorial: point out that domain to ASCII fails on U+FFFD]] ([[annevk]]著, [TIME[2017-01-29 19:26:14 +09:00]]) [55] [CITE@en[Allow % and IPv6 addresses in non-special URL hosts]] ([[rmisev]]著, [TIME[2017-02-09 03:43:20 +09:00]]) [56] [CITE@en[Remove host parser's Unicode flag as it's unnecessary]] ([[annevk]]著, [TIME[2017-02-13 23:05:28 +09:00]]) [32] [CITE@en[Attempt to explain valid input better]] ([[annevk]]著, [TIME[2017-02-10 17:10:23 +09:00]]) [47] [CITE@en[Add empty host concept for file and non-special URLs]] ([[rmisev]]著, [TIME[2017-03-07 23:12:16 +09:00]]) [48] [CITE@en[Add empty host concept for file and non-special URLs]] ([[rmisev]]著, [TIME[2017-03-07 23:12:16 +09:00]]) [50] [CITE@en[Define percent decoding of strings]] ([[annevk]]著, [TIME[2017-10-10 21:45:20 +09:00]]) [51] [CITE@en[Give host parser a suitable default for the HTML Standard]] ([[annevk]]著, [TIME[2018-05-30 16:40:26 +09:00]]) [59] [CITE@en[Give host parser a suitable default for the HTML Standard by annevk · Pull Request #388 · whatwg/url]] ([TIME[2018-06-04 18:39:17 +09:00]])