* 仕様書 [REFS[ - [12] '''[CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2016-02-04 17:09:00 +09:00]] 版) ''' - [11] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2015-11-04 19:30:07 +09:00]] 版) ]REFS] * [CODE(DOMi)@en[Location]] オブジェクト [23] [CODE(DOMi)@en[[[Location]]]] [[オブジェクト]]は、 [[閲覧文脈]]の[F[[[活性文書]]]]の[F[[[文書の番地]]]]を表します。 また、[[閲覧文脈]]の[F[[[セッション履歴]]]]を変更する [[API]] を提供します。 [SRC[>>12]] [FIG(list members)[ : [DFN[[F(ss)[DefaultProperties]]]] : 作成時点での自身の[[プロパティー]]のリストです [SRC[>>12]]。 : [F[文書]] : 当該[[オブジェクト]]が関連付けられた[[文書]]です。 : [DFN[[F[[RUBYB[[[関係する[CODE(DOMi)@en[Document]]]]][relevant [CODE(DOMi)@en[Document]]]]]]]] : [F[文書]]の[F[閲覧文脈]]の[F[活性文書]]です [SRC[>>12]]。 : [DFN[[F[[RUBYB[URL][url]]]]]] : [F[[[関係する[CODE(DOMi)@en[Document]]]]の[F[文書の番地]]です [SRC[>>12]]。 : [F[祖先起源群配列]] : [CODE(DOMa)@en[ancestorOrigins]] [[IDL属性]]の値です。 ]FIG] [7] [CODE(DOMi)@en[[[URLUtils]]]] としての動作は [CODE(JS)@en[[[location.href]]]] を参照。 ** メンバー [1] [FIG(list short)[ - [CODE(DOMa)@en[hash]] - [CODE(DOMa)@en[host]] - [CODE(DOMa)@en[hostname]] - [CODE(DOMa)@en[href][location.href]] - [CODE(DOMa)@en[pathname]] - [CODE(DOMa)@en[port]] - [CODE(DOMa)@en[protocol]] - [CODE(DOMa)@en[search]] - [CODE(DOMm)@en[reload]] - [CODE(DOMm)@en[replace]] - [CODE(DOMm)@en[assign]] ]FIG] * [CODE(DOMi)@en[WorkerLocation]] インターフェイス (DOM) [10] [CODE(DOMi)@en[[[WorkerLocation]]]] [[オブジェクト]]は、 [CODE(DOMi)@en[[[WorkerGlobalScope]]]] [[オブジェクト]]の[F[[[URL]]]] を表します。 * [CODE(DOMa)@en[location]] IDL属性 [21] [DFN[[CODE(JS)@en[[[window.location]]]]]] [[IDL属性]]の[[取得器]]は、 次のようにしなければ[['''なりません''']] [SRC[>>12]]。 [FIG(steps)[ = [22] [[文脈オブジェクト]]の [F[[CODE(DOMi)@en[Location]]]]を返します。 ]FIG] [16] [DFN[[CODE(JS)@en[[[document.location]]]]]] [[IDL属性]]の[[取得器]]は、 次のようにしなければ[['''なりません''']] [SRC[>>12]]。 [FIG(steps)[ = [17] [[文脈オブジェクト]]が[F[完全に活性]]なら、 == [18] [[文脈オブジェクト]]の[F[関連大域オブジェクト]]の [F[[CODE(DOMi)@en[Location]]]]を返します。 = [19] それ以外なら、 == [20] [CODE[null]] を返します。 ]FIG] [85] [CODE[window.location]] と [CODE[document.location]] は [CODE[[[PutForwards]]=[[href][location.href]]]] です。 [SRC[>>12]] つまり、 [CODE[[[window.location]] = [VAR[url]]]] は [CODE[[[window.location]].[[href][location.href]] = [VAR[url]]]] と等価です。 [88] なお [CODE[location.href]] は [CODE[stringifier]] として定義されています。 従って [CODE[Location]] オブジェクトの [CODE[toString]] [[メソッド]]は [CODE[location.href]] の[[取得器]]と等価です。 つまり、 [CODE[window.location]] を[[文字列]]連結すると [CODE[location.href]] とみなされます。 ;; [86] 実際の [[Webページ]]の [[JavaScript]] では [CODE[window.location]] やその省略形の [CODE[location]] を使う場合が多く、 [CODE[document.location]] はあまり使われません。 ;; [87] [CODE[[[window.location]] = [VAR[url]]]] や [CODE[[[location]] = [VAR[url]]]] はわかりにくいので、 [CODE[[[window.location]].[[href][location.href]] = [VAR[url]]]] と書くことが多いです。 [HISTORY[ [89] 先日 [[SNS]] で [CODE[window.location]] の [[setter]] は [CITE[HTML Standard]] に規定がないとか解説している人を見かけましたが、 誤りです。 初期の初期からしっかり[[規定]]されています。 そのように[[仕様書]]を引いてもっともらしいことを書いていても、 正確に読み込んでいるとは限らないので注意しましょう。 [TIME[2022-04-25T13:29:24.00Z]] ]HISTORY] * 文脈 [13] [CODE(DOMi)@en[[[Window]]]] [[オブジェクト]]は、 固有の [CODE(DOMi)@en[[[Location]]]] [[オブジェクト]]を持ちます。 [CODE(DOMi)@en[[[Window]]]] [[オブジェクト]]の作成時に [CODE(DOMi)@en[[[Location]]]] [[オブジェクト]]が割り当てられます。 [SRC[>>12]] [HISTORY[ [14] [CODE(JS)@en[[[document.open]]]] で [CODE(DOMi)@en[[[Location]]]] [[オブジェクト]]は新しいものに差し替えられるとされていましたが、 その規定は削除されています。 ]HISTORY] * 作成 [24] [CODE(DOMi)@en[Location][Location (DOM)]] [[オブジェクト]]の作成は、次のようにします [SRC[>>12]]。 [FIG(steps)[ = [25] [VAR[オブジェクト]]を、新しい [CODE(DOMi)@en[Location][Location (DOM)]] [[プラットフォームオブジェクト]]に設定します。 [VAR[オブジェクト]]の [F(JS ss)@en[DefineOwnProperty]] を実行して次の通りメンバーを作成します。 [FIG(table)[ :name: 名前 (第1引数) :Value: [F(ss)[Value]] :Writable: [F(ss)[Writable]] :Enumerable: [F(ss)[Enumerable]] :Configurable: [F(ss)[Configurable]] :name: [CODE[toString]] :Value: [CODE[%ObjProto_toString%]] :Writable: [CODE[false]] :Enumerable: [CODE[false]] :Configurable: [CODE[false]] :name: [CODE[toJSON]] :Value: [CODE[undefined]] :Writable: [CODE[false]] :Enumerable: [CODE[false]] :Configurable: [CODE[false]] :name: [CODE[valueOf]] :Value: [CODE[%ObjProto_valueOf%]] :Writable: [CODE[false]] :Enumerable: [CODE[false]] :Configurable: [CODE[false]] :name: [CODE[@@toPrimitive]] :Value: [CODE[undefined]] :Writable: [CODE[false]] :Enumerable: [CODE[false]] :Configurable: [CODE[false]] ]FIG] = [26] [VAR[オブジェクト]]の [F(ss)[DefaultProperties]] を、 [VAR[オブジェクト]]の [F(ss)[OwnPropertyKeys]] を実行した結果に設定します。 = [27] [VAR[オブジェクト]]を返します。 ]FIG] [31] 更に、 [F[祖先起源群配列]]を設定しなければ[MUST[なりません]]。 * 異なる起源からのアクセス [42] [CODE(DOMi)@en[Location]] は、[[同じ起源]]でなくてもアクセスできる例外的な[[オブジェクト]]です。 (そのような性質を持つのは他に [CODE(DOMi)@en[WindowProxy]] だけです。) [43] [[同じ起源]]からアクセスした時と、それ以外からアクセスした時とで、 動作がかなり変わります。 [44] [[JavaScript]] の[[内部メソッド]]は次のように動作しなければ[MUST[なりません]] [SRC[>>12]]。 [FIG(table)[ :method: [[内部メソッド]] :params: [[引数]] :same: [CODE[[[IsPlatformObjectSameOrigin]]([[this]])]] が[[真]] :cross: [CODE[[[IsPlatformObjectSameOrigin]]([[this]])]] が[[偽]] :method: [60] [F(ss)[GetPrototypeOf]] :same: [CODE[[[!][! (ECMAScript)]] [[OrdinaryGetPrototypeOf]]([[this]])]] を返します。 :cross: [[null]] を返します。 :method: [61] [F(ss)[SetPrototypeOf]] :same: [[偽]]を返します。 :cross: [[偽]]を返します。 :method: [62] [F(ss)[IsExtensible]] :same: [[真]]を返します。 :cross: [[真]]を返します。 :method: [63] [F(ss)[PreventExtensions]] :same: [[偽]]を返します。 :cross: [[偽]]を返します。 :method: [64] [F(ss)[GetOwnProperty]] :params: [VAR[P]] :same: [FIG(steps)[ = [32] [VAR[desc]] を、 [CODE[[[OrdinaryGetOwnProperty]]([[this]], [VAR[P]])]] に設定します。 = [33] [CODE[this]] の [F(ss)[DefaultProperties]] の値に [VAR[P]] が含まれるなら、 == [34] [VAR[desc]] の [F(ss)[Configurable]] を[[真]]に設定します。 = [35] [VAR[desc]] を返します。 ]FIG] :cross: [FIG(steps)[ = [37] [VAR[特性]]を、 [CODE[[[!][! (ECMAScript)]] [[CrossOriginGetOwnPropertyHelper]]([[this]], [VAR[P]])]] に設定します。 = [38] [VAR[特性]]が[[未定義]]でなければ、 == [39] [VAR[特性]]を返します。 = [40] それ以外なら、 == [41] [CODE(DOMe)@en[SecurityError]] [[例外]]を[[投げ]]ます。 ]FIG] :method: [65] [F(ss)[DefineOwnProperty]] :params: [VAR[P]], [VAR[Desc]] :same: [FIG(steps)[ = [46] [CODE[this]] の[F(ss)[DefaultProperties]]の値が [VAR[P]] を含むなら、 == [47] [[偽]]を返します。 = [48] それ以外なら、 == [49] [CODE[[[?][? (ECMAScript)]] [[OrdinaryDefineOwnProperty]]([[this]], [VAR[P]], [VAR[Desc]])]] を返します。 ]FIG] :cross: [[偽]]を返します。 :method: [66] [F(ss)[Get]] :params: [VAR[P]], [VAR[Receiver]] :same: [CODE[[[?][? (ECMAScript)]] [[OrdinaryGet]]([[this]], [VAR[P]], [VAR[Receiver]])]] を返します。 :cross: [CODE[[[?][? (ECMAScript)]] [[CrossOriginGet]]([[this]], [VAR[P]], [VAR[Receiver]])]] を返します。 :method: [67] [F(ss)[Set]] :params: [VAR[P]], [VAR[V]], [VAR[Receiver]] :same: [CODE[[[?][? (ECMAScript)]] [[OrdinarySet]]([[this]], [VAR[P]], [VAR[V]], [VAR[Receiver]])]] を返します。 :cross: [CODE[[[?][? (ECMAScript)]] [[CrossOriginSet]]([[this]], [VAR[P]], [VAR[V]], [VAR[Receiver]])]] を返します。 :method: [68] [F(ss)[Delete]] :params: [VAR[P]] :same: [CODE[[[?][? (ECMAScript)]] [[OrdinaryDelete]]([[this]], [VAR[P]])]] を返します。 :cross: [[偽]]を返します。 :method: [69] [F(ss)[OwnPropertyKeys]] :same: [CODE[[[!][! (ECMAScript)]] [[OrdinaryOwnPropertyKeys]]([[this]])]] を返します。 :cross: [CODE[[[!][! (ECMAScript)]] [[CrossOriginOwnPropertyKeys]]([[this]])]] を返します。 ]FIG] * 歴史 ** JavaScript 1.0 [28] [[JavaScript 1.0]] で [CODE(DOMi)@en[Location][Location (DOM)]] [[オブジェクト]]が導入され、[[URL分解属性]]が追加されました。 [FIG(list short)[ - [CODE(DOMa)@en[hash]] - [CODE(DOMa)@en[host]] - [CODE(DOMa)@en[hostname]] - [CODE(DOMa)@en[href][location.href]] - [CODE(DOMa)@en[pathname]] - [CODE(DOMa)@en[port]] - [CODE(DOMa)@en[protocol]] - [CODE(DOMa)@en[search]] ]FIG] ** JavaScript 1.1 [29] [[JavaScript 1.1]] で [CODE(DOMm)@en[reload]] と [CODE(DOMm)@en[replace]] が追加されました。 ** @@ [30] [CODE(JS)@en[location.origin]] は10年代に追加されました。 * メモ [2] [CITE@en[Re: WebIDL and prototype chains]] ([[Maciej Stachowiak]] 著, [TIME[2009-07-17 12:39:39 +09:00]] 版) [3] [CITE['''['''whatwg''']''' JS "redirects" and session history]] ([TIME[2010-07-28 08:22:37 +09:00]] 版) [4] [CITE@en[Web Applications 1.0 r7512 Make sure