windows

与浏览器窗口进行交互。您可以使用此 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

当前获得焦点的窗口发生变化时触发。

扩展程序示例

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.windows API。本文档来源于 Chromium 代码中的 windows.json