[8] [[閲覧文脈の作成]]は、[[窓]]を開くなどの[[利用者]]の操作により、 あるいは [CODE(HTMLe)@en[[[iframe]]]] [[要素]]の挿入などの[[スクリプト]]の操作により、 行われます。 [41] [[閲覧文脈]]を作成すると、[[閲覧文脈]]に対応する [[JavaScript]] [[オブジェクト]]であり[[大域オブジェクト]]でもある [CODE(DOMi)@en[[[Window]]]] と、 [[JavaScript]] から実際にアクセスできる[[オブジェクト]]である [CODE(DOM)@en[[[WindowProxy]]]] が作成されます。更に、 [[閲覧文脈]]の初期状態である [CODE(URI)@en[[[about:blank]]]] の[[文書]]が作成されます。 そしてこれらの関連付けと初期化が行われます。 * 仕様書 [REFS[ - [1] '''[CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2015-05-06 10:42:35 +09:00]] 版) ''' - [19] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2015-05-06 10:42:35 +09:00]] 版) - [25] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2015-05-06 10:42:35 +09:00]] 版) - [29] [CITE@en[Upgrade Insecure Requests]] ([TIME[2015-10-07 03:24:10 +09:00]] 版) - [64] [CITE@en[High Resolution Time Level 2]] ([TIME[2016-02-26 04:49:50 +09:00]]) - [90] [CITE@en[Mixed Content]], [TIME[2020-04-28 21:05:56 +09:00]] ]REFS] * 文脈 [9] 次の場面で[[閲覧文脈の作成]]が呼び出されます。 [FIG(list)[ - 新しい[[窓]]や[[タブ]]を開いた場合 - [[閲覧文脈の選択]] -- [[the rules for choosing a browsing context given a browsing context name]] で新たに[[閲覧文脈]]を開く場合 [SRC[[[HTML Standard]]]] -- [[ハイパーリンクをたどる]]際に新しい[[閲覧文脈]]を使う場合 -- [[フォームの提出]]で新しい[[閲覧文脈]]を使う場合 -- [CODE(JS)@en[[[window.open]]]] で新しい[[閲覧文脈]]を使う場合 - [[フレーム]]の[[文書への挿入]] [SRC[[[HTML Standard]]]] - [CODE(HTMLe)@en[[[object]]]] [[要素]]で[[閲覧文脈]]を使う場合 - [CODE(HTMLe)@en[[[embed]]]] [[要素]]で[[閲覧文脈]]を使う場合 - [DEL[[CODE(DOMm)@en[[[showModalDialog]]]] [SRC[[[HTML Standard]]]]]] ]FIG] * 処理 [2] [DFN[[RUBYB[[RUBY[新][あたら]]しい[RUBY[閲覧文脈][えつらんぶんみゃく]]の[RUBY[作成][さくせい]]]@en[create a new browsing context]]]] [SRC[>>1]] は、 [VAR[作成子閲覧文脈]] ([[閲覧文脈]]または無指定)、 [VAR[入れ子か最上位か]]、[VAR[[[補助閲覧文脈]]か否か]]、 [VAR[noopener]] ([[既定値]]は[[偽]])、 [[閲覧文脈群]][VAR[群]]を、 次のようにします。 [FIG(steps)[ = [24] [VAR[[[作成子起源]]]]を、[VAR[作成子文書]]の[F[起源][文書の起源]]に設定します。 = [50] [VAR[閲覧文脈]]を、新しい[[閲覧文脈]]に設定します。 [FIG(list members)[ [49] [[閲覧文脈]] :[F[入れ子か最上位か]]: [VAR[入れ子か最上位か]] :[F[[[補助閲覧文脈]]か]]: [VAR[[[補助閲覧文脈]]か否か]] :[F[[[作成子閲覧文脈]]]]: [VAR[作成子閲覧文脈]] : [F[作成子基底URL]] : [VAR[作成子閲覧文脈]]が [[null]] なら [[null]]、 それ以外なら[VAR[作成子閲覧文脈]]の[F[活性文書]]の[F[基底URL][文書基底URL]] :[F[[[[CODE(HTMLe)@en[iframe]] sandboxing flag set]]]]: [CODE(HTMLa)@en[sandbox]] [[属性]]を [[parse the sandboxing directive]] して得た[[砂箱化フラグ集合]] ([CODE(HTMLe)@en[[[iframe]]]] [[入れ子閲覧文脈]]の場合) [SRC[>>19]]。 ]FIG] = [48] [VAR[窓]]を、新しい [CODE(DOMi)@en[[[Window]]]] に設定します [SRC[>>1]]。 = [86] [VAR[機能ポリシー]]を、 [VAR[閲覧文脈]]と[VAR[起源]]について[[機能ポリシーを作成]]した結果に設定します。 = [98] [VAR[エージェント]]を、 [VAR[起源]]と[VAR[群]]について[[類似起源窓エージェントを得る]]結果に設定します。 [SRC[>>1]] = [18] [VAR[砂箱フラグ群]]を、 [VAR[閲覧文脈]]について[[砂箱化フラグ群を決定]]した結果に設定します。 [SRC[>>1]] = [100] [VAR[起源]]を、 [[起源を決定]]した結果に設定します。 [SRC[>>1]] [FIG(list members)[ : [VAR[閲覧文脈]] : [VAR[閲覧文脈]] : [VAR[URL]] : [CODE[about:blank]] : [VAR[砂箱化フラグ集合]] : [VAR[砂箱フラグ群]] : [VAR[呼び出し起源]] : [VAR[閲覧文脈]]の[F[作成子起源]] : [VAR[活性文書navigate起源]] : [CODE[null]] ]FIG] = [47] [VAR[realm実行文脈]]を、 [[新しいJavaScript realmの作成]]の結果に設定します [SRC[>>1]]。 [FIG(list members)[ :[[大域オブジェクト]]: [VAR[窓]] :[[大域[CODE(JS)[this]]束縛]]: [VAR[閲覧文脈]]の [F[[CODE(DOMi)@en[WindowProxy]]]] : [VAR[エージェント]] : [VAR[エージェント]] ]FIG] = [52] [VAR[設定群オブジェクト]]を、 [VAR[realm実行文脈]]について[[閲覧文脈環境設定群オブジェクトの設定]]を行った結果に設定します [SRC[>>1]]。 = [15] [VAR[文書]]を、新しい[DFN[[RUBYB[初期「[CODE(URI)@en[about:blank]]」[[文書]]]@en[initial "[CODE(URI)@en[about:blank]]" document]]]]に設定します [SRC[>>1]]。 [FIG(list members)[ [FIGCAPTION[ [53] [[文書]] ]FIGCAPTION] :[F[[[型]]]]: [[HTML文書]] :[F[[[ready for post-load tasks]]]]: [[真]] :[F[[[completely loaded]]]]: [[真]] :[F[[[子供節点]]]]: [CODE(HTMLe)@en[[[html]]]] [[要素]]。その[[子供]]は [CODE(HTMLe)@en[[[head]]]] [[要素]]と [CODE(HTMLe)@en[[[body]]]] [[要素]] (いずれも[[空]])。 : [F[時刻起源]] : 現在時刻 [SRC[>>64]] : [F[起源][文書の起源]] : [VAR[起源]] : [F[機能ポリシー]] : [VAR[機能ポリシー]] : [F[活性砂箱化フラグ集合]] : [VAR[砂箱フラグ群]] ]FIG] = [16] [VAR[閲覧文脈]]について[VAR[文書]]に[[活性文書を設定]]します [SRC[>>1]]。 = [37] [VAR[閲覧文脈]]の[F[作成子URL]]が [CODE[null]] ''以外''の場合、 == [71] [VAR[作成子文書]]を、[VAR[作成子閲覧文脈]]の[F[活性文書]]に設定します。 == [42] [VAR[文書]]の[F[参照元][文書のreferrer]]を、[VAR[作成子文書]]の[F[番地][文書の番地]]に設定します。 == [35] [VAR[文書]]の[F[参照元ポリシー]]を、[VAR[作成子文書]]の[F[参照元ポリシー]]に設定します。 = [75] [VAR[文書]]について[[set the allow* flags]]します。 [SRC[>>1]] = [17] [VAR[閲覧文脈]]の[F[[[セッション履歴]]]]に、 新しい[[セッション履歴エントリー]]を追加します [SRC[>>1]]。 [FIG(list members)[ [FIGCAPTION[ [45] [[セッション履歴エントリー]] ]FIGCAPTION] :[F[[[文書]]]]: [VAR[文書]] ]FIG] = [22] [VAR[入れ子か最上位か]]が[[最上位閲覧文脈]]の場合、 == [77] [VAR[noopener]] が[[偽]]で、 [VAR[作成子起源]]が[VAR[文書]]の[F[起源][文書の起源]]と[[同じ起源]]の場合、 === [23] [VAR[作成子閲覧文脈]]の[VAR[作成子起源]]に関する [CODE[sessionStorage]] 蓄積領域を[VAR[閲覧文脈]]へと'''複製'''します。 [SRC[>>1]] = [30] [VAR[入れ子か最上位か]]が[[入れ子閲覧文脈]]の場合、 [SRC[>>29]] == [31] [[閲覧文脈]]の [[embedding document]] の[[非保安要求ポリシー]]が「格上げする」なら、 === [32] [[閲覧文脈]]の[[非保安要求ポリシー]]を、「格上げする」に設定します。 === [33] [[閲覧文脈]]の [[embedding document]] の[[非保安navigate格上げ集合]]の各値について、 [[閲覧文脈]]の[[非保安navigate格上げ集合]]に追加します。 == [91] [VAR[閲覧文脈]]の[F[埋め込んでいる文書]]の[F[厳密混合内容検査フラグ]]が[[真]]の場合、 [SRC[>>90]] === [92] [VAR[閲覧文脈]]の[F[厳密混合内容検査フラグ]]を、 [[真]]に設定します。 = [63] [CODE[webNavigation]] API の [CODE[onCreatedNavigationTarget]] を現在時刻と共に実行します。 [SRC[仕様書なし]] = [51] [VAR[閲覧文脈]]を返します [SRC[>>1]]。 ]FIG] ;; [26] [[閲覧文脈]]の複製というのが具体的にどのような操作なのかは不明です。 そのような [[API]] は無さそうですが、そのような[[利用者]]の操作を実装している [[Webブラウザー]]があります (例えば [[Chrome]] は[[タブ]]の複製操作があります)。 ;; [27] 新しい[[閲覧文脈]]に関係する[[文書]]については、[[閲覧文脈の選択]]を参照。 ([[閲覧文脈の選択]]によらない場合でも、理論上は [[Webブラウザー]]依存の方法 ([[UI]]) から新しい[[閲覧文脈]]を作成した場合で該当することはあるかもしれません。) ;; [20] [[閲覧文脈]]の作成後、 (本作成手順の呼び出し元で) [[閲覧文脈名]]が設定されることになります。 [10] [CODE(DOMi)@en[[[Window]]]] は[[大域オブジェクト]]ですから、 付随して[[環境設定群オブジェクト]]、 [[JavaScript]] 実行環境、 [[Web IDL]] [[インターフェイスオブジェクト]]なども作られます。 この [CODE(DOMi)@en[[[Window]]]] は、 [[navigate]] により次の[[文書]]に再利用されることがあります。 ;; [[文書オブジェクトの初期化]]参照。 [11] 本項の初期化手順の後に、[[閲覧文脈]]が使われる各文脈に依存した次の処理が (必要なら) 行われます。 [12] [[Webブラウザー]]で新たな[[タブ]]を開いたことによる[[閲覧文脈]]の作成の場合には、 などの [[Webブラウザー]]依存の初期ページや、 [[利用者]]の設定した[[ホームページ]]へと[[置換有効]]で [[navigate]] されます。 [13] 外部アプリケーションから [[Webブラウザー]]に [[URL]] を指定して起動 (あるいは[[プロセス間通信]]により [[URL]] を開くことを指示) した場合には、その [[URL]] へと[[置換有効]]で [[navigate]] されます。 [14] [[お気に入り]]や閲覧[[履歴]]などの [[Webブラウザー]]依存の[[利用者インターフェイス]]を通して [[URL]] を指定して新しい[[閲覧履歴]]が開かれた場合には、 その [[URL]] へと[[置換有効]]で [[navigate]] されます。 [28] 作成した[[閲覧文脈]]がいつ[[利用者]]に表示されるかは、作成される場面や[[利用者エージェント]]の設計方針により異なります。 [[入れ子閲覧文脈]]の場合は、次の[[レンダリングの更新]]の時点と思われます。 [[最上位閲覧文脈]]の場合は、ただちに表示されるのが普通と思われますが、 敢えてそうしないこともあるかもしれません ([[navigate]] 参照)。 ;; [[閲覧文脈の作成]]の呼び出し元で、[[閲覧文脈]]の表示サイズなどの設定が行われることがあります。 [CODE(JS)@en[[[window.open]]]] や[[閲覧文脈の選択]]を参照。 [54] いずれにせよ、 [[閲覧文脈の作成]]と前後して、その[[閲覧文脈]]の表示のための[[窓]]や[[タブ]]、 関係する[[利用者インターフェイス]]などの作成と初期化を適宜行う必要があります。 ;; [55] その具体的な方法やタイミングは環境や実装方法に依存しますし、 [[Web互換性]]に直接影響しないので、[[標準化]]されていません。 [36] [[閲覧文脈]]は、 [DFN[[F[[RUBYB[[[作成子閲覧文脈]]]@en[creator browsing context]]]]]]、 [DFN[[F[[RUBYB[[[作成子URL]]]@en[creator URL]]]]]]、 [DFN[[F[[RUBYB[[[作成子基底URL]]]@en[creator base URL]]]]]]、 [DFN[[F[[RUBYB[[[作成子起源]]]@en[creator origin]]]]]] [SRC[>>1]] を持ちます。 これらは[[閲覧文脈の作成]]時に (あれば) 設定されます。 [F[作成子閲覧文脈]]は、いくつかの処理で参照されます。 [F[作成子基底URL]]は、[F[フォールバック基底URL]]の決定で参照されます。 [F[作成子URL]]と[F[作成子起源]]は、 [[仕様書]]上の[[新しい閲覧文脈の作成]]手順群でのみ参照されるので、 実際には[[閲覧文脈]]の状態として保持し続ける必要はありません。 [HISTORY[ [44] かつては[F[作成子閲覧文脈]]と[DFN[[F[[RUBYB[作成子[CODE(DOM)@en[Document]]]@en[creator [CODE(DOM)@en[Document]]]]]]]]でした。 [94] 一時は [DFN[[F[[RUBYB[[[作成子文脈セキュリティー]]]@en[creator context security]]]]]]や[DFN[[F[[RUBYB[[[作成子参照元ポリシー]]]@en[creator referrer policy]]]]]]がありました。 ]HISTORY] * 最初の [CODE(JS)@en[about:blank]] 文書 [4] [[閲覧文脈の作成]]時に作成される[[文書]]は、仕様書中では 「[[閲覧文脈]]作成時に追加された [CODE(URI)@en[[[about:blank]]]] [[文書]]」、 「初期『[CODE(URI)@en[about:blank]]』文書」などと呼ばれます。 [21] [[閲覧文脈]]作成時に[[セッション履歴]]に追加された [CODE(URI)@en[[[about:blank]]]] [[文書]]は、次の場面で特別に扱われます。 [FIG(short list)[ - [[文書オブジェクトの初期化]] - [CODE(JS)@en[[[location.assign]]]] - [CODE(JS)@en[[[document.open]]]] - [CODE(JS)@en[[[window.open]]]] - [[フレーム]] - [CODE(JS)@en[[[history.length]]]] ]FIG] [5] 初期文書かどうかは、[[置換有効]]で [[navigate]] するかどうかの判断に使われます。 つまり初期文書は当該[[閲覧文脈]]で [[navigate]] が最初に発生した時に[[セッション履歴]]から削除されることになります。 [6] この判断は初期文書かどうか否かで行うので、[[スクリプト]]により内容を操作しているか否かは影響しません。 (ただし [CODE(JS)@en[[[document.open]]]] や [CODE(DOMm)@en[[[pushState]]]] で[[セッション履歴エントリー]]が新たに追加されていれば、 初期文書が唯一の[[セッション履歴エントリー]]であるとの条件を満たさなくなります。) [7] [CODE(DOMm)@en[[[replaceState]]]] や [CODE(JS)@en[[[document.open]]]] で[[セッション履歴エントリー]]が置換された場合で [[URL]] が [CODE(URI)@en[[[about:blank]]]] でなくなった場合、 あるいは [CODE(URI)@en[[[about:blank]]]] のままで[[セッション履歴エントリー]]が置き換わった場合にどう影響するのかは明確ではありません。 [[初期「[CODE(URI)@en[about:blank]]」文書]]であるかどうかの判断が[[文書]]に於けるものか[[セッション履歴エントリー]]に於けるものかで変わってきます。 * 歴史 [34] [CITE@en[Refactor browsing context creation · whatwg/html@357f649]] ([TIME[2015-12-16 16:04:28 +09:00]] 版) [46] [CITE@en[Rewrite global object initialization to delegate to ES · whatwg/html@cf0355d]] ([TIME[2015-12-16 18:15:51 +09:00]] 版) [56] [CITE@en[Rewrite script execution on top of ES · whatwg/html@4891d18]] ([TIME[2015-12-22 18:52:25 +09:00]] 版) [57] [CITE@en[Define security around Window, WindowProxy, and Location properly · whatwg/html@acae3df]] ([TIME[2016-03-13 23:23:39 +09:00]] 版) [58] [CITE@en[Remove the origin aliasing concept · whatwg/html@438155d]] ([TIME[2016-03-23 22:18:13 +09:00]] 版) [59] [CITE@en[Sync with recent changes to the JS spec's job queue · whatwg/html@5af258f]] ([TIME[2016-03-24 21:42:47 +09:00]] 版) [60] [CITE@en[Define the origin of non-initial about:blank documents · whatwg/html@baad9fd]] ([TIME[2016-03-25 13:33:29 +09:00]] 版) [61] [CITE@en[Merge effective script origin into origin · whatwg/html@8a843f2]] ([TIME[2016-03-31 16:42:54 +09:00]] 版) [40] [CITE@en[Remove the concept of creator Document so we don't leak a document · whatwg/html@a996f3b]] ([TIME[2016-04-06 17:18:18 +09:00]] 版) [3] [CITE@en[Integrate with the Referrer Policy spec, part 2 of n]] ( ([[domenic]]著, [TIME[2016-05-18 01:52:35 +09:00]])) [62] [CITE@en[Cleanup "create a new browsing context"]] ( ([[annevk]]著, [TIME[2016-06-10 02:54:12 +09:00]])) [65] [CITE@en[Define initial about:blank document better]] ( ([[annevk]]著, [TIME[2016-06-21 13:53:01 +09:00]])) [66] [CITE@en[Use fullscreen logic for initial about:blank documents too]] ( ([[annevk]]著, [TIME[2016-06-09 21:47:29 +09:00]])) [67] [CITE@en[Make allowfullscreen and allowusermedia match implementations]] ([[annevk]]著, [TIME[2016-07-07 04:47:42 +09:00]]) [68] [CITE@en[Add 'creator context security']] ([[mikewest]]著, [TIME[2016-07-16 04:27:52 +09:00]]) [69] [CITE@en[Fixing some links and cleaning up lists.]] ([[mikewest]]著, [TIME[2016-07-15 22:00:54 +09:00]]) [72] [CITE@en[Add environment's execution ready flag]] ([[jungkees]]著, [TIME[2016-11-09 19:26:26 +09:00]]) [74] [CITE@en[Snapshot allowpaymentrequest and allowusermedia attributes]] ([[zcorpan]]著, [TIME[2017-01-15 01:54:58 +09:00]]) [76] [CITE@en[Centralize setting the active document]] ([[annevk]]著, [TIME[2017-05-18 13:20:38 +09:00]]) [73] [CITE@en[Make noopener stop the copying of session storage]] ([[mystor]]著, [TIME[2017-09-06 06:56:03 +09:00]]) [78] [CITE@en[Mention `sessionStorage` copying in logic for creating auxiliary browsing contexts · Issue #2681 · whatwg/html]] ([TIME[2017-09-10 20:51:36 +09:00]]) [79] [CITE@en[Mention sessionStorage copying in logic for creating a new browsing context by mystor · Pull Request #2832 · whatwg/html]] ([TIME[2017-09-10 20:53:21 +09:00]]) [80] [CITE@en[Drop creator context security]] ([[annevk]]著, [TIME[2017-10-21 20:12:36 +09:00]]) [70] [CITE@en[Creator context security used incorrectly · Issue #48 · w3c/webappsec-secure-contexts]] ([TIME[2017-10-23 17:33:24 +09:00]]) [81] [CITE@en[Drop creator context security by annevk · Pull Request #3150 · whatwg/html]] ([TIME[2017-10-23 17:34:15 +09:00]]) [82] [CITE@en[Editorial: Define "realm execution context" in a separate step]] ([[TimothyGu]]著, [TIME[2018-01-15 08:06:05 +09:00]]) [84] [CITE@en[Editorial: Define "realm execution context" in a separate step by TimothyGu · Pull Request #3314 · whatwg/html]] ([TIME[2018-02-12 13:41:10 +09:00]]) [85] [CITE@en[Fix calls to InitializeHostDefinedRealm]] ([[TimothyGu]]著, [TIME[2018-07-29 04:10:47 +09:00]]) [83] [CITE@en[Editorial: initialize feature policy before document creation]] ([[dtapuska]]著, [TIME[2019-07-19 01:23:50 +09:00]]) [87] [CITE@en[Editorial: initialize feature policy before document creation]] ([[dtapuska]]著, [TIME[2019-07-19 01:23:50 +09:00]]) [88] [CITE@en[Expose new algorithms to create a Feature Policy before document is c… by dtapuska · Pull Request #324 · w3c/webappsec-feature-policy]] ([TIME[2020-05-14 15:29:50 +09:00]]) [89] [CITE@en[Use the newly exposed methods to initialize feature policy. by dtapuska · Pull Request #4772 · whatwg/html]] ([TIME[2020-05-14 15:31:06 +09:00]]) [93] [CITE@en[Editorial: inline "creator referrer policy"]] ([[shvaikalesh]], [TIME[2019-06-28 21:15:54 +09:00]], [TIME[2021-03-26T12:21:50.000Z]]) [95] [CITE@en[Inline "creator referrer policy" · Issue #4721 · whatwg/html]] ([TIME[2021-03-26T12:33:22.000Z]]) [96] [CITE@en[Editorial: inline "creator referrer policy" by shvaikalesh · Pull Request #4740 · whatwg/html]] ([TIME[2021-03-26T12:33:48.000Z]]) [97] [CITE@en[Imperatively allocate window agents and agent clusters]] ([[dtapuska]], [TIME[2019-09-10 02:41:12 +09:00]], [TIME[2021-04-13T09:26:22.000Z]]) [99] [CITE@en[Refactor the navigation algorithm]] ([[dtapuska]], [TIME[2019-07-12 00:49:55 +09:00]], [TIME[2021-07-01T09:41:37.000Z]]) [38] [CITE@en[Refactor navigation algorithm. by dtapuska · Pull Request #4664 · whatwg/html]] ([TIME[2021-07-02T08:22:48.000Z]]) [39] [CITE@en[Snapshot sandbox at the start of navigation]] ([[clelland]], [TIME[2019-11-26 01:42:48 +09:00]], [TIME[2022-01-14T09:54:57.000Z]])