窗口
与浏览器窗口交互。您可以使用此 API 获取有关打开窗口的信息,以及打开、修改和关闭窗口。您还可以侦听窗口打开、关闭和激活事件。
类型
windows.WindowType
-
此浏览器窗口的类型。
windows.WindowState
-
此浏览器窗口的状态。
windows.Window
-
包含有关浏览器窗口的信息。
windows.CreateType
-
指定要创建的浏览器窗口的类型。
常量
windows.WINDOW_ID_NONE
-
表示不存在浏览器窗口的
windowId
值。 windows.WINDOW_ID_CURRENT
-
可以在某些 API 中用作
windowId
的值,以表示当前窗口。
方法
windows.get()
-
根据 ID 获取有关窗口的详细信息。
windows.getCurrent()
-
获取当前窗口。
windows.getLastFocused()
-
获取最近获得焦点的窗口,通常是“最上面”的窗口。
windows.getAll()
-
获取所有窗口。
windows.create()
-
创建一个新窗口。
windows.update()
-
更新窗口的属性。使用此方法可以移动、调整窗口大小以及(取消)聚焦窗口等。
windows.remove()
-
关闭窗口及其所有标签页。
事件
windows.onBoundsChanged
-
当窗口大小调整或移动时触发。
windows.onCreated
-
当创建窗口时触发。
windows.onRemoved
-
当关闭窗口时触发。
windows.onFocusChanged
-
当当前获得焦点的窗口发生变化时触发。
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
示例扩展
注意:此 API 基于 Chromium 的 chrome.windows
API。本文档源自 Chromium 代码中的 windows.json
。