windows

与浏览器窗口互动。你可以使用此 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

当前有焦点的窗口改变时触发。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
windows
CreateType
WINDOW_ID_CURRENT
WINDOW_ID_NONE
Window
Window.alwaysOnTop
Window.focused
Window.height
Window.id
Window.incognito
Window.left
Window.sessionId
Window.state
Window.tabs
Window.title
Window.top
Window.type
Window.width
WindowState
WindowState.docked
WindowState.fullscreen
WindowState.maximized
WindowState.minimized
WindowType
WindowType.app
WindowType.devtools
WindowType.panel
create
get
get.getInfo
getInfo.windowTypes
getAll
getAll.populate
getAll.windowTypes
getCurrent
getCurrent.getInfo
getInfo.windowTypes
getLastFocused
getLastFocused.getInfo
getInfo.windowTypes
onBoundsChanged
onCreated
onFocusChanged
onRemoved
remove
update
update.drawAttention
update.focused
update.height
update.left
update.state
update.titlePreface
update.top
update.width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Uses a non-standard name.

Edge 的不兼容

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

示例扩展

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

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