ブラウザーウィンドウと相互作用します。この API を使って開いているウィンドウの情報を取得したり、ウィンドウを開き、修正し、閉じることができます。ウィンドウのオープン、クローズ、アクティベートのイベントをリッスンすることもできます。

windows.WindowType
ブラウザーウィンドウの this の型。
windows.WindowState
ブラウザーウィンドウの状態。
windows.Window
ブラウザーウィンドウについての情報を含む。
windows.CreateType
作成するブラウザーウィンドウの型を指定する。

プロパティ

windows.WINDOW_ID_NONE
ブラウザーウィンドウがないことを表す windowId の値。
windows.WINDOW_ID_CURRENT
現在のウィンドウを表す windowId の値。

関数

windows.get()
与えられた IDのウィンドウの詳細を取得します。
windows.getCurrent()
現在のウィンドウを取得します。
windows.getLastFocused()
最も最近フォーカスされたウィンドウを取得します — 典型的には「最上位」のウィンドウです。
windows.getAll()
すべてのウィンドウを取得します。
windows.create()

新しいウィンドウを作成します。

windows.update()
ウィンドウのプロパティを更新します。これを使ってウィンドウの移動、リサイズ、フォーカス(外し)などを行います。
windows.remove()
ウィンドウと、そのタブのすべてを閉じます。

イベント

windows.onCreated
ウィンドウが作成された時に発火します。
windows.onRemoved
ウィンドウが閉じられた時に発火します。
windows.onFocusChanged
現在フォーカスされているウィンドウが変わった時に発火します。

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
CreateTypeChrome 完全対応 あり
補足
完全対応 あり
補足
補足 `detached_panel` is not supported.
Edge 完全対応 14
補足
完全対応 14
補足
補足 `panel` and `detached_panel` are not supported.
Firefox 完全対応 45Opera 完全対応 あり
補足
完全対応 あり
補足
補足 `detached_panel` is not supported.
Firefox Android 未対応 なし
WINDOW_ID_CURRENTChrome 完全対応 18Edge 完全対応 14Firefox 完全対応 45Opera 完全対応 15Firefox Android 未対応 なし
WINDOW_ID_NONEChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
WindowChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
WindowStateChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
WindowTypeChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
createChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45
補足
完全対応 45
補足
補足 'url' and 'tabId options can't both be set together.
補足 The returned 'Window' object contains the 'tabs' property only from version 52 onwards.
Opera 完全対応 ありFirefox Android 未対応 なし
getChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
getAllChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
getCurrentChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
getLastFocusedChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
onCreatedChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
onFocusChangedChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
onRemovedChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
removeChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし
updateChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

Example extensions

Acknowledgements

This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

ドキュメントのタグと貢献者

このページの貢献者: Uemmra3
最終更新者: Uemmra3,