与浏览器窗口互动。您可以使用此 API 获取有关已打开窗口的信息,以及打开、修改和关闭窗口。您也可以监听窗口的打开、关闭和其激活事件。

类型

windows.WindowType
浏览器窗口的类型。
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
当前有焦点的窗口改变时触发。

浏览器兼容性

Chrome Edge Firefox Firefox for Android Opera
CreateType Yes Yes 45.0 No 33
WINDOW_ID_CURRENT Yes Yes 45.0 No 33
WINDOW_ID_NONE Yes Yes 45.0 No 33
Window Yes Yes * 45.0 No 33
WindowState Yes Yes 45.0 No 33
WindowType Yes Yes 45.0 No 33
create Yes Yes 45.0 * No 33
get Yes Yes 45.0 No 33
getAll Yes Yes 45.0 No 33
getCurrent Yes Yes 45.0 No 33
getLastFocused Yes Yes 45.0 No 33
onCreated Yes Yes 45.0 No 33
onFocusChanged Yes Yes 45.0 No 33
onRemoved Yes No 45.0 No 33
remove Yes No 45.0 No 33
update Yes Yes 45.0 No 33

Edge 的不兼容

Edge 中不支持 Promises。需使用回调。

Chrome incompatibilities

windows

  • In Firefox onFocusChanged will trigger multiple times for a given focus change.

Example add-ons

声明

此 API 基于 Chromium 的 chrome.windows API。此文档基于 Chromium 代码中的 windows.json

Microsoft Edge 兼容性数据由微软公司提供,并包含在创作共用 署名 3.0美国许可证下。

文档标签和贡献者

 此页面的贡献者: yfdyh000
 最后编辑者: yfdyh000,