1. 7.2 Windowオブジェクト
      1. 7.2.1 名前でブラウジングコンテキストを作成および操作するためのAPI
      2. 7.2.2 他のブラウジングコンテキストへのアクセス
      3. 7.2.3 Windowオブジェクトの名前付きアクセス
      4. 7.2.4 ブラウジングコンテキストを閉じる
      5. 7.2.5 ブラウザーインターフェイス要素

7.2 Windowオブジェクト

Window

Support in all current engines.

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
window.window
window.frames
window.self

これらの属性はすべてwindowを返す。

window.document

windowと関連するDocumentを返す。

document.defaultView

アクティブ文書Windowオブジェクトを返す。

7.2.1 名前でブラウジングコンテキストを作成および操作するためのAPI

window = window.open([ url [, target [, features ] ] ])

url(デフォルトで"about:blank")を表示するためのウィンドウを開き、それを返す。target(デフォルトで"_blank")は、新しいウィンドウの名前を示す。すでにその名前をもつウィンドウが存在する場合、それが再利用される。features引数はコンマ区切りトークンの集合を含むことができる:

"noopener"
"noreferrer"

これらは、ハイパーリンク上のnoopenerおよびnoreferrerリンクタイプと同等に動作する。

"popup"

ユーザーエージェントに、新しいウィンドウに最小限のウェブブラウザーユーザーインターフェイスを提供するように促す。 (すべてのBarPropオブジェクトにもvisibleゲッターに影響を与える。)

globalThis.open("https://email.example/message/CAOOOkFcWW97r8yg=SsWg7GgCmp4suVX9o85y8BvNRqMjuc5PXg", undefined, "noopener,popup");
window.name [ = value ]

ウィンドウの名前を返す。

名前を変更する設定が可能である。

window.close()

ウィンドウを閉じる。

window.closed

ウィンドウが閉じられている場合はtrueを返し、そうでなければfalseを返す。

window.stop()

ドキュメントの読み込みを中止する。

7.2.2 他のブラウジングコンテキストへのアクセス

window.length

文書ツリー子ブラウジングコンテキストの数を返す。

window[index]

指示された文書ツリー子ブラウジングコンテキストを返す。

7.2.3 Windowオブジェクトの名前付きアクセス

window[name]

指示された要素または要素のコレクションを返す。

一般的な規則として、これに依存することはもろいコードを導く。たとえば、新しい機能がウェブプラットフォームに加えられるように、いずれかのIDがこのAPIのマッピングで終わることは時間をかけて変化できる。この代わりに、document.getElementById()またはdocument.querySelector()を使用する。

7.2.4 ブラウジングコンテキストを閉じる

To close a browsing context browsingContext, run these steps:

  1. If the result of calling prompt to unload with browsingContext's active document is "refuse", then return.

  2. Unload browsingContext's active document.

  3. Remove browsingContext from the user interface (e.g., close or hide its tab in a tabbed browser).

  4. Discard browsingContext.

ユーザーエージェントは、ユーザーが任意に任意のトップレベルブラウジングコンテキスト閉じる機能を提供すべきである。

7.2.5 ブラウザーインターフェイス要素

歴史的な理由から、Windowインターフェイスには、特定のウェブブラウザーインターフェイス要素の可視性を表すいくつかの属性があった。

プライバシーと相互運用性の理由から、これらの属性は、Windowブラウジングコンテキストポップアッププロパティがtrueかfalseかを表す値を返すようになった。

各インターフェイス要素はBarPropオブジェクトによって表される:

window.locationbar.visible

BarProp/visible

Support in all current engines.

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
window.menubar.visible
window.personalbar.visible
window.scrollbars.visible
window.statusbar.visible
window.toolbar.visible

トップレベルブラウジングコンテキストがポップアップでない場合、trueを返す。そうでなければ、falseを返す。