| BrowserWindow([options]) |
创建一个新的BrowserWindow实例 |
支持 |
| BrowserWindow.fromBrowserView(browserView) |
根据 browserView 查找其所在的窗口实例。 |
支持 |
| BrowserWindow.fromId(id) |
根据唯一 ID 查找对应的窗口实例。 |
支持 |
| BrowserWindow.fromWebContents(webContents) |
根据 webContents 查找对应的窗口实例。 |
支持 |
| BrowserWindow.getAllWindows() |
返回所有现存 BrowserWindow 实例的数组。 |
支持 |
| BrowserWindow.getFocusedWindow() |
返回当前获得焦点的窗口，若无则返回 null。 |
支持 |
| win.addBrowserView(browserView) |
向窗口添加一个额外的 BrowserView。 |
支持 |
| win.addTabbedWindow(browserWindow) |
将另一个窗口作为标签页添加到当前窗口。 |
不支持 |
| win.blur() |
使窗口失去焦点。 |
支持 |
| win.blurWebView() |
使 Web 内容区失去焦点。 |
支持 |
| win.capturePage([rect, opts]) |
对窗口当前可见区域进行截图并返回 NativeImage。 |
支持 |
| win.center() |
将窗口移动到屏幕中心位置。 |
支持 |
| win.close() |
尝试关闭窗口，会触发 close 事件。 |
支持 |
| win.closeFilePreview() |
关闭原生文件预览窗口。 |
不支持 |
| win.destroy() |
立即强制关闭窗口，不触发 close 事件。 |
支持 |
| win.flashFrame(flag) |
开启或关闭任务栏图标的闪烁提醒。 |
不支持 |
| win.focus() |
使窗口获得焦点并移至最前。 |
支持 |
| win.focusOnWebView() |
将焦点移到 Web 内容区。 |
支持 |
| win.getBackgroundColor() |
返回当前窗口的背景颜色。 |
支持 |
| win.getBounds() |
返回窗口的坐标和大小对象。 |
支持 |
| win.getBrowserView() |
返回当前窗口的主 BrowserView。 |
支持 |
| win.getBrowserViews() |
获取窗口中加载的所有 BrowserView 列表。 |
支持 |
| win.getChildWindows() |
获取当前窗口的所有子窗口列表。 |
支持 |
| win.getContentBounds() |
返回窗口客户区的大小和位置。 |
支持 |
| win.getContentSize() |
返回客户区的宽高数组。 |
支持 |
| win.getMaximumSize() |
返回窗口最大宽高的数组。 |
支持 |
| win.getMediaSourceId() |
获取用于 desktopCapturer 的媒体源 ID。 |
支持 |
| win.getMinimumSize() |
返回窗口最小宽高的数组。 |
支持 |
| win.getNativeWindowHandle() |
获取底层操作系统的窗口句柄 Buffer。 |
支持 |
| win.getNormalBounds() |
返回窗口在非最大/最小化时的正常坐标大小。 |
支持 |
| win.getOpacity() |
返回窗口当前透明度。 |
支持 |
| win.getParentWindow() |
获取当前窗口的父窗口实例。 |
支持 |
| win.getPosition() |
返回包含窗口 X Y 坐标的数组。 |
支持 |
| win.getRepresentedFilename() |
获取窗口代表的文件路径。 |
不支持 |
| win.getSize() |
返回包含窗口宽高的数组。 |
支持 |
| win.getTitle() |
获取窗口当前标题文字。 |
支持 |
| win.getWindowButtonPosition() |
获取 macOS 标题栏按钮的当前位置坐标。 |
不支持 |
| win.hasShadow() |
返回窗口是否有阴影。 |
支持 |
| win.hide() |
隐藏窗口。 |
支持 |
| win.hookWindowMessage(message, callback) |
拦截底层的 Windows 窗口消息。 |
不支持 |
| win.invalidateShadow() |
强制刷新窗口阴影。 |
不支持 |
| win.isAlwaysOnTop() |
返回当前是否开启了置顶模式。 |
支持 |
| win.isClosable() |
返回窗口是否可关闭。 |
支持 |
| win.isDestroyed() |
返回窗口对象是否已被销毁。 |
支持 |
| win.isDocumentEdited() |
返回文档编辑状态。 |
不支持 |
| win.isEnabled() |
返回窗口是否处于启用状态。 |
支持 |
| win.isFocusable() |
返回窗口是否可聚焦。 |
支持 |
| win.isFocused() |
返回窗口是否处于激活焦点状态。 |
支持 |
| win.isFullScreen() |
返回窗口当前是否处于全屏状态。 |
支持 |
| win.isFullScreenable() |
返回窗口是否可进入全屏。 |
支持 |
| win.isHiddenInMissionControl() |
返回是否在 Mission Control 中隐藏。 |
不支持 |
| win.isKiosk() |
返回是否处于 Kiosk 模式。 |
支持 |
| win.isMaximizable() |
返回窗口是否可最大化。 |
支持 |
| win.isMaximized() |
返回窗口当前是否处于最大化状态。 |
支持 |
| win.isMenuBarAutoHide() |
返回是否开启了自动隐藏菜单。 |
不支持 |
| win.isMenuBarVisible() |
返回菜单栏可见性。 |
不支持 |
| win.isMinimizable() |
返回窗口是否可最小化。 |
支持 |
| win.isMinimized() |
返回窗口当前是否处于最小化状态。 |
支持 |
| win.isModal() |
返回窗口是否为模态窗口。 |
支持 |
| win.isMovable() |
返回窗口是否可移动。 |
支持 |
| win.isNormal() |
返回窗口是否处于正常状态（非最大/最小/全屏）。 |
支持 |
| win.isResizable() |
返回窗口是否可调整大小。 |
支持 |
| win.isSimpleFullScreen() |
返回是否处于简单全屏模式。 |
支持 |
| win.isTabletMode() |
返回 Windows 10 是否处于平板模式。 |
不支持 |
| win.isVisible() |
返回窗口当前是否对用户可见。 |
支持 |
| win.isVisibleOnAllWorkspaces() |
返回窗口是否在所有桌面可见。 |
支持 |
| win.isWindowMessageHooked(message) |
检查是否已拦截特定的窗口消息。 |
不支持 |
| win.loadFile(filePath[, options]) |
在窗口中加载本地 HTML 文件。 |
支持 |
| win.loadURL(url[, options]) |
在窗口中加载指定的 URL 地址。 |
支持 |
| win.maximize() |
使窗口最大化。 |
支持 |
| win.mergeAllWindows() |
将所有打开的窗口合并为一个带标签的窗口。 |
不支持 |
| win.minimize() |
使窗口最小化。 |
支持 |
| win.moveAbove(mediaSourceId) |
将窗口移动到指定窗口上方。 |
不支持 |
| win.moveTabToNewWindow() |
将当前选中的标签页拖出成为新窗口。 |
不支持 |
| win.moveTop() |
将窗口移至屏幕最顶层 Z 轴。 |
支持 |
| win.previewFile(path[, displayName]) |
使用系统原生预览功能查看文件。 |
不支持 |
| win.reload() |
刷新当前页面。 |
支持 |
| win.removeBrowserView(browserView) |
从窗口移除指定的 BrowserView。 |
支持 |
| win.removeMenu() |
移除窗口顶部的菜单栏。 |
支持 |
| win.restore() |
从最小化状态恢复窗口。 |
支持 |
| win.selectNextTab() |
在 macOS 标签栏切换到下一个标签页。 |
不支持 |
| win.selectPreviousTab() |
在 macOS 标签栏切换到上一个标签页。 |
不支持 |
| win.setAlwaysOnTop(flag[, level][, relativeLevel]) |
设置窗口始终浮在其他应用上方。 |
支持 |
| win.setAppDetails(options) |
设置窗口的任务栏分组与详细属性。 |
不支持 |
| win.setAspectRatio(aspectRatio[, extraSize]) |
设置窗口维持的固定宽高比。 |
支持 |
| win.setAutoHideCursor(autoHide) |
设置输入时是否自动隐藏鼠标光标。 |
不支持 |
| win.setAutoHideMenuBar(hide) |
设置是否自动隐藏菜单栏（按 Alt 键显示）。 |
不支持 |
| win.setBackgroundColor(backgroundColor) |
设置窗口背景颜色（如 #FFFFFF）。 |
支持 |
| win.setBackgroundMaterial(material) |
设置窗口底层材质（Mica/Acrylic）。 |
不支持 |
| win.setBounds(bounds[, animate]) |
设置窗口的坐标(x、y)和大小(width、height） |
支持 |
| win.setBrowserView(browserView) |
替换窗口中的 BrowserView。 |
支持 |
| win.setClosable(closable) |
设置窗口是否允许用户手动关闭。 |
支持 |
| win.setContentBounds(bounds[, animate]) |
设置窗口客户区（内容区）的坐标和大小。 |
支持 |
| win.setContentProtection(enable) |
禁止窗口内容被录屏或截图。 |
支持 |
| win.setContentSize(width, height[, animate]) |
调整窗口客户区（内容区）的宽高。 |
支持 |
| win.setDocumentEdited(edited) |
设置文档是否已编辑状态。 |
不支持 |
| win.setEnabled(enable) |
启用或禁用窗口交互。 |
支持 |
| win.setFocusable(focusable) |
设置窗口是否可以获得键盘焦点。 |
支持 |
| win.setFullScreen(flag) |
设置窗口进入或退出全屏模式。 |
支持 |
| win.setFullScreenable(fullscreenable) |
设置窗口是否可以由用户触发全屏操作。 |
支持 |
| win.setHasShadow(hasShadow) |
设置窗口是否显示系统阴影。 |
不支持 |
| win.setHiddenInMissionControl(hidden) |
设置是否在任务控制（Mission Control）中隐藏该窗口。 |
不支持 |
| win.setIcon(icon) |
设置窗口标题栏和任务栏的图标。 |
支持 |
| win.setIgnoreMouseEvents(ignore[, options]) |
设置窗口是否忽略所有鼠标事件（穿透）。 |
支持 |
| win.setKiosk(flag) |
开启或关闭全屏演示（Kiosk）模式。 |
支持 |
| win.setMaximizable(maximizable) |
设置是否允许用户点击最大化按钮。 |
支持 |
| win.setMaximumSize(width, height) |
设置窗口允许的最大宽高限制。 |
支持 |
| win.setMenu(menu) |
设置窗口顶部的菜单栏（设为 null 可移除）。 |
支持 |
| win.setMenuBarVisibility(visible) |
设置菜单栏是否对用户可见。 |
不支持 |
| win.setMinimizable(minimizable) |
设置是否允许用户点击最小化按钮。 |
支持 |
| win.setMinimumSize(width, height) |
设置窗口允许的最小宽高限制。 |
支持 |
| win.setMovable(movable) |
设置用户是否可以手动拖动窗口。 |
支持 |
| win.setOpacity(opacity) |
设置窗口透明度（0-1）。 |
支持 |
| win.setOverlayIcon(overlay, description) |
在任务栏图标上叠加一个小图标。 |
不支持 |
| win.setParentWindow(parent) |
设置当前窗口的父窗口（设为 null 则变为顶级窗口）。 |
支持 |
| win.setPosition(x, y[, animate]) |
将窗口移动到指定的屏幕坐标点。 |
支持 |
| win.setProgressBar(progress[, options]) |
设置任务栏图标上的进度条（0-1）。 |
不支持 |
| win.setRepresentedFilename(filename) |
设置窗口代表的文件路径，标题栏会显示关联图标。 |
不支持 |
| win.setResizable(resizable) |
设置用户是否可以手动拉伸调整窗口大小。 |
支持 |
| win.setShape(rects) |
设置窗口的形状（非矩形窗口）。 |
不支持 |
| win.setSheetOffset(offsetY[, offsetX]) |
设置 macOS Sheet 对话框相对于窗口的偏移量。 |
不支持 |
| win.setSimpleFullScreen(flag) |
设置进入或退出 macOS 简单全屏模式。 |
支持 |
| win.setSize(width, height[, animate]) |
调整窗口的宽高。 |
支持 |
| win.setSkipTaskbar(skip) |
设置是否在任务栏/Dock 中隐藏图标。 |
不支持 |
| win.setThumbarButtons(buttons) |
在任务栏预览图中添加一组操作按钮。 |
不支持 |
| win.setThumbnailClip(region) |
设置任务栏预览图的剪裁区域。 |
不支持 |
| win.setThumbnailToolTip(toolTip) |
设置任务栏预览图的悬浮提示文字。 |
不支持 |
| win.setTitle(title) |
设置窗口标题文字。 |
支持 |
| win.setTitleBarOverlay(options) |
在 Windows 叠加层模式下设置标题栏控制按钮样式。 |
不支持 |
| win.setTopBrowserView(browserView) |
将指定的 BrowserView 移至最顶层。 |
支持 |
| win.setTouchBar(touchBar) |
设置自定义的 Touch Bar 内容。 |
不支持 |
| win.setVibrancy(type) |
设置窗口的视觉震动（毛玻璃/半透明）效果。 |
不支持 |
| win.setVisibleOnAllWorkspaces(visible[, options]) |
设置窗口在所有虚拟桌面上是否可见。 |
支持 |
| win.setWindowButtonPosition(position) |
调整 macOS 标题栏按钮的精确位置。 |
不支持 |
| win.setWindowButtonVisibility(visible) |
在 macOS 无边框窗口下隐藏或显示红绿灯按钮。 |
支持 |
| win.show() |
显示窗口并将焦点移至其上。 |
支持 |
| win.showAllTabs() |
展示当前应用的所有标签页缩略图。 |
不支持 |
| win.showDefinitionForSelection() |
在 macOS 上显示选中文本的字典定义信息。 |
不支持 |
| win.showInactive() |
显示窗口但不夺取当前焦点。 |
不支持 |
| win.toggleTabBar() |
切换 macOS 标签栏的显示/隐藏。 |
不支持 |
| win.unhookAllWindowMessages() |
停止拦截所有的窗口消息。 |
不支持 |
| win.unhookWindowMessage(message) |
停止拦截特定的窗口消息。 |
不支持 |
| win.unmaximize() |
从最大化状态退出。 |
支持 |
