HTML: The Living Standard

Edition for Web Developers — Last Updated 15 October 2021

1. 7 ウェブページの読み込み
   1. 7.1 ブラウジングコンテキスト
      1. 7.1.1 ブラウジングコンテキストを作成する
      2. 7.1.2 関連するブラウジングコンテキスト
         1. 7.1.2.1 DOMで関連するブラウジングコンテキストをナビゲートする
      3. 7.1.3 ブラウジングコンテキスト名

7 ウェブページの読み込み

7.1 ブラウジングコンテキスト

ブラウジングコンテキストはDocumentオブジェクトがユーザーに提示される環境である。

iframeを含むと同様に、ウェブブラウザーにおいてタブやウィンドウは通常、ブラウジングコンテキストを含む。

ブラウジングコンテキストは、対応するWindowProxyオブジェクトを持つ。

ブラウジングコンテキストは、オープナーブラウジングコンテキストを持ち、これはnullまたはブラウジングコンテキストである最初はnullである。

ブラウジングコンテキストは、不所有の真偽値を持つ。最初はfalseである。

ブラウジングコンテキストは、閉じている真偽値を持つ。最初はfalseである。

// Neither disowned nor is closing:
const popup1 = window.open();

// Disowned, but not is closing:
const popup2 = window.open();
popup2.opener = null;

// Not disowned, but is closing:
const popup3 = window.open();
popup3.close();

// Disowned, is closing:
const popup4 = window.open();
popup4.opener = null;
popup4.close();

ブラウジングコンテキストは、ブラウジングコンテキストが提示されていた、している、またはするだろうDocumentオブジェクトを一覧表示するセッション履歴を持つ。Documentのブラウジングコンテキストは、そのようなブラウジングコンテキストが存在しかつ破棄されていない場合、セッション履歴にそのDocumentが含まれるブラウジングコンテキストであり、そうでなければnullである。

Documentは、必ずしも非nullのブラウジングコンテキストを持つとは限らない。具体的には、データマイニングツールはブラウジングコンテキストをインスタンス化できないだろう。createDocument()のような API を使用して作成されたDocumentは、非nullのブラウジングコンテキストを持つことはない。文書から削除されて以来、iframe要素で当初は作成されたDocumentは、そのブラウジングコンテキストが破棄されたので、関連付けられたブラウジングコンテキストを持たない。

ブラウジングコンテキストのアクティブウィンドウは、その WindowProxyオブジェクトの[[Window]]内部スロット値である。ブラウジングコンテキストのアクティブ文書は、そのアクティブウィンドウに関連付けられたDocumentである。

一般に、Documentオブジェクトが非nullブラウジングコンテキストを持っている限り、WindowオブジェクトからDocumentオブジェクトへのマッピングは1対1になる。例外が1つある。Windowは、マッピングが1対2になるように、同じブラウジングコンテキストで2番目のDocumentのプレゼンテーションに再利用できる。This occurs when a browsing context is navigated from the initial about:blank Document to another, with historyHandling set to "replace".

A browsing context has a virtual browsing context group ID integer. It is initially 0. This is used by cross-origin opener policy reporting, to keep track of the browsing context group switches that would have happened if the report-only policy had been enforced.

A browsing context has an initial URL, which is a URL or null. 最初はnullである。

A browsing context has an opener origin at creation, which is an origin or null. 最初はnullである。

7.1.1 ブラウジングコンテキストを作成する

DocumentオブジェクトdocumentにブラウジングコンテキストbrowsingContextのアクティブ文書を設定するには、次の手順を実行する：

1. windowをdocumentの関連するグローバルオブジェクトにする。

2. browsingContextのアクティブウィンドウをwindowに設定する。

3. windowの関連Documentをdocumentに設定する。

4. windowの関連設定オブジェクトの実行準備フラグを設定する。

ブラウジングコンテキストは、関連付けられている作成者の生成元（nullまたは生成元を返す）、作成者のURL（nullまたはURLを返す）、および作成者のベースURL（nullまたはURLを返す）を持つ。これらは最初はnullである。

7.1.2 関連するブラウジングコンテキスト

特定の要素（たとえば、iframe要素）は、ブラウジングコンテキストをさらにインスタンス化できる。この要素は、ブラウジングコンテキストコンテナーと呼ばれる。

各ブラウジングコンテキストコンテナーは、ブラウジングコンテキストまたはnullのいずれとなる、ネストされたブラウジングコンテキストを持つ。最初はnullである。

ブラウジングコンテキストbcのコンテナーは、ネストされたブラウジングコンテキストがbcであるブラウジングコンテキストコンテナーであり、そのような要素がない場合はnullである。

各ブラウジングコンテキストbcは、コンテナー文書を持ち、これは次の手順を実行した結果である：

1. bcのコンテナーがnullである場合、nullを返す。

2. bcのコンテナーのノード文書を返す。

   bcのコンテナーを接続する必要があるため、これはbcのコンテナーのシャドウを含むルートと同じである。

childのコンテナー文書がnullでなく、かつchildのコンテナー文書のブラウジングコンテキストがparentである場合、ブラウジングコンテキストchildは、別のブラウジングコンテキストparentの子ブラウジングコンテキストと呼ばれる。

ブラウジングコンテキストchildは、childが子ブラウジングコンテキストであり、かつchildのコンテナーが文書ツリー内である場合、parentの文書ツリーの子ブラウジングコンテキストである。

ブラウジングコンテキストchildは親ブラウジングコンテキストを持ってもよい。もしそのようなブラウジングコンテキストが存在すれば、これは子ブラウジングコンテキストとしてchildを持つ一意なブラウジングコンテキストである。そうでなければ、ブラウジングコンテキストは、親ブラウジングコンテキストを持たない。

ブラウジングコンテキストAがAの子ブラウジングコンテキストであり、かつBの祖先自身であるブラウジングコンテキストA'が存在する場合、またはブラウジングコンテキストAがBの親ブラウジングコンテキストである場合、ブラウジングコンテキストBの祖先であると言われる。

親ブラウジングコンテキストを持たないブラウジングコンテキストは、それ自身のトップレベルブラウジングコンテキストであり、祖先ブラウジングコンテキストであるブラウジングコンテキストのすべてとなる。

トップレベルブラウジングコンテキストは、関連するグループ（nullまたはブラウジングコンテキストグループ）を持つ。最初はnullである。

コンテナーがnullの間に、トップレベルブラウジングコンテキストに関連する新しいブラウジングコンテキストを作成することができる。そのようなブラウジングコンテキストは、補助ブラウジングコンテキストと呼ばれる。補助ブラウジングコンテキストは常にトップレベルブラウジングコンテキストである。

子ブラウジングコンテキストであるブラウジングコンテキストに対する親ブラウジングコンテキストの推移的クロージャは、祖先ブラウジングコンテキストのリストを与える。

Document dの子孫ブラウジングコンテキストのリストは、以下のアルゴリズムによって返される（順序付きの）リストである：

1. listを空のリストにする。

2. ネストされたブラウジングコンテキストがnullでなく、シャドウを含むルートがdである各ブラウジングコンテキストコンテナーcontainerごとに、シャドウを含むツリーの順序で：

   1. nestedBCをコンテナーのネストされたブラウジングコンテキストにする。

   2. nestedBCをlistに追加する。

   3. nestedBCのアクティブ文書の子孫ブラウジングコンテキストのリストでlistを拡張する。

3. listを返す。

A Document d is said to be fully active when d's browsing context is non-null, d's browsing context's active document is d, and either d's browsing context is a top-level browsing context, or d's browsing context's container document is fully active.

子ブラウジングコンテキストは要素に関連付けられているため、常にその親ブラウジングコンテキスト内の特定のDocumentに関連付けられている。 ユーザーエージェントは、ユーザーにがいない自身が完全にアクティブでないDocumentにある要素の子ブラウジングコンテキストと対話することを許可してはならない。

<!-- a.html -->
<!DOCTYPE html>
<html lang="en">
<title>Browsing context A</title>

<iframe src="b-1.html"></iframe>
<button onclick="frames[0].location.href = 'b-2.html'">Click me</button>

<!-- b-1.html -->
<!DOCTYPE html>
<html lang="en">
<title>Browsing context B</title>

<iframe src="c.html"></iframe>

子ブラウジングコンテキストは、遅延loadイベントモードにすることができる。新しいDocumentが作成される前に、コンテナーのロードイベントを遅延させるために、ナビゲート時に使用される。

ブラウジングコンテキストの文書ファミリーは、そのブラウジングコンテキストのセッション履歴ですべてのDocumentオブジェクト、およびすべてのそれらDocumentオブジェクトの文書ファミリーの和集合で構成される。Documentオブジェクトの文書ファミリーは、Documentオブジェクトの子孫のブラウジングコンテキストのリストにあるブラウジングコンテキストのすべての文書ファミリーの和集合で構成されている。

ブラウジングコンテキストコンテナー containerのコンテンツ文書は、次のアルゴリズムの結果である：

1. containerのネストされたブラウジングコンテキストがnullである場合、nullを返す。

2. contextをcontainerのネストされたブラウジングコンテキストにする。

3. documentをcontextのアクティブ文書にする。

4. documentの生成元およびcontainerのノード文書の生成元が同一生成元ドメインでない場合、nullを返す。

5. documentを返す。

7.1.2.1 DOMで関連するブラウジングコンテキストをナビゲートする

window.top

トップレベルブラウジングコンテキストのWindowProxyを返す。

window.opener [ = value ]

オープナーブラウジングコンテキストに対するWindowProxyを返す。

存在しないまたはnullが設定されている場合、nullを返す。

nullに設定可能である。

window.parent

親ブラウジングコンテキストに対するWindowProxyを返す。

window.frameElement

ブラウジングコンテキストコンテナーのElementを返す。

存在しない場合、生成元をまたいだ状況でnullを返す。

7.1.3 ブラウジングコンテキスト名

ブラウジングコンテキストは、ブラウジングコンテキスト名を持つことができる。特に明記しない限り、それは空文字列である。

妥当なブラウジングコンテキスト名は、U+005F LOW LINE文字で始まらない少なくとも1文字をもつ任意の文字列である。（アンダースコアで始まる名前は、特別なキーワードのために予約されている。）

妥当なブラウジングコンテキスト名またはキーワードは、妥当なブラウジングコンテキスト名またはASCII大文字・小文字不区別で_blank、_self、_parent、または_topの1つに一致するいずれかとなる任意の文字列である。

これらの値は、以下の（非規範的な）テーブルで要約されるように、ページがサンドボックス化されるかどうかに基づいて異なる意味を持つ。この表において、"current"はリンクまたはスクリプト内にあるブラウジングコンテキストを意味し、"parent"はリンクまたはスクリプト内にあるいずれかの親ブラウジングコンテキストを意味し、"top"はリンクまたはスクリプトがあるいずれかのトップレベルブラウジングコンテキストを意味し、"new"はさまざまなユーザー設定とユーザーエージェントのポリシーに次第で、新しいトップレベルブラウジングコンテキストまたは補助ブラウジングコンテキストが作成されることを意味し、"none"は何も起こらないことを意味し、"maybe new"は"allow-popups"キーワードはまたsandbox属性で指定される場合（またはユーザーがサンドボックスを覆う場合）、"new"と同じであり、そうでなければ"none"と同じである。

サンドボックス化されたブラウジングコンテキストの制限のほとんどは、他のアルゴリズムにより適用される。たとえば、下記で与えられるブラウジングコンテキスト名で与えられたをブラウジングコンテキストを選択するための規則でなく、ナビゲーションアルゴリズムとして。