BrowserWindow

BrowserWindow

A string property that defines an alternative title provided only to accessibility tools such as screen readers. This string is not directly visible to users.

A boolean property that determines whether the window menu bar should hide itself automatically. Once set, the menu bar will only show when users press the single Alt key.

A boolean property that determines whether the window can be manually closed by user.

A View property for the content view of the window.

A boolean property that specifies whether the window’s document has been edited.

A boolean property that determines whether the window is excluded from the application’s Windows menu. false by default.

A boolean property that determines whether the window is focusable.

A boolean property that determines whether the window is in fullscreen mode.

A boolean property that determines whether the maximize/zoom window button toggles fullscreen mode or maximizes the window.

A Integer property representing the unique ID of the window. Each ID is unique among all BrowserWindow instances of the entire Electron application.

A boolean property that determines whether the window is in kiosk mode.

A boolean property that determines whether the window can be manually maximized by user.

A boolean property that determines whether the menu bar should be visible.

A boolean property that determines whether the window can be manually minimized by user.

A boolean property that determines Whether the window can be moved by user.

A string property that determines the pathname of the file the window represents, and the icon of the file will show in window's title bar.

A boolean property that determines whether the window can be manually resized by user.

A boolean property that determines whether the window has a shadow.

A boolean property that determines whether the window is in simple (pre-Lion) fullscreen mode.

A string (optional) property that is equal to the tabbingIdentifier passed to the BrowserWindow constructor or undefined if none was set.

A string property that determines the title of the native window.

A boolean property that determines whether the window is visible on all workspaces.

A WebContents object this window owns. All web page related events and operations will be done via it.

Replacement API for setBrowserView supporting work with multi browser views.

Adds a window as a tab on this window, after the tab for the window instance.

Removes focus from the window.

Resolves with a NativeImage

Moves window to the center of the screen.

Try to close the window. This has the same effect as a user manually clicking the close button of the window. The web page may cancel the close though. See the close event.

Closes the currently open Quick Look panel.

Force closing the window, the unload and beforeunload event won't be emitted for the web page, and close event will also not be emitted for this window, but it guarantees the closed event will be emitted.

Starts or stops flashing the window to attract user's attention.

Focuses on the window.

Gets the background color of the window in Hex (#RRGGBB) format.

The bounds of the window as Object.

The BrowserView attached to win. Returns null if one is not attached. Throws an error if multiple BrowserViews are attached.

a sorted by z-index array of all BrowserViews that have been attached with addBrowserView or setBrowserView. The top-most BrowserView is the last element of the array.

All child windows.

The bounds of the window's client area as Object.

Contains the window's client area's width and height.

The content view of the window.

Contains the window's maximum width and height.

Window id in the format of DesktopCapturerSource's id. For example "window:1324:0".

Contains the window's minimum width and height.

The platform-specific handle of the window.

Contains the window bounds of the normal state

between 0.0 (fully transparent) and 1.0 (fully opaque). On Linux, always returns

The parent window or null if there is no parent.

Contains the window's current position.

The pathname of the file the window represents.

Contains the window's width and height.

The title of the native window.

The custom position for the traffic light buttons in frameless window, null will be returned when there is no custom position.

Whether the window has a shadow.

Hides the window.

Hooks a windows message. The callback is called when the message is received in the WndProc.

Invalidates the window shadow so that it is recomputed based on the current window shape.

Whether the window is always on top of other windows.

Whether the window can be manually closed by user.

Whether the window is destroyed.

Whether the window's document has been edited.

whether the window is enabled.

Whether the window can be focused.

Whether the window is focused.

Whether the window is in fullscreen mode.

Whether the maximize/zoom window button toggles fullscreen mode or maximizes the window.

Whether the window will be hidden when the user toggles into mission control.

Whether the window is in kiosk mode.

Whether the window can be manually maximized by user.

Whether the window is maximized.

Whether menu bar automatically hides itself.

Whether the menu bar is visible.

Whether the window can be manually minimized by the user.

Whether the window is minimized.

Whether current window is a modal window.

Whether the window can be moved by user.

Whether the window is in normal state (not maximized, not minimized, not in fullscreen mode).

Whether the window can be manually resized by the user.

Whether the window is in simple (pre-Lion) fullscreen mode.

Whether the window is in Windows 10 tablet mode.

Whether the window is visible to the user in the foreground of the app.

Whether the window is visible on all workspaces.

true or false depending on whether the message is hooked.

the promise will resolve when the page has finished loading (see did-finish-load), and rejects if the page fails to load (see did-fail-load).

the promise will resolve when the page has finished loading (see did-finish-load), and rejects if the page fails to load (see did-fail-load).

Maximizes the window. This will also show (but not focus) the window if it isn't being displayed already.

Merges all windows into one window with multiple tabs when native tabs are enabled and there is more than one open window.

Minimizes the window. On some platforms the minimized window will be shown in the Dock.

Moves window above the source window in the sense of z-order. If the mediaSourceId is not of type window or if the window does not exist then this method throws an error.

Moves the current tab into a new window if native tabs are enabled and there is more than one tab in the current window.

Moves window to top(z-order) regardless of focus

Uses Quick Look to preview a file at a given path.

Same as webContents.reload.

Remove the window's menu bar.

Restores the window from minimized state to its previous state.

Selects the next tab when native tabs are enabled and there are other tabs in the window.

Selects the previous tab when native tabs are enabled and there are other tabs in the window.

Sets whether the window should show always on top of other windows. After setting this, the window is still a normal window, not a toolbox window which can not be focused on.

Sets the properties for the window's taskbar button.

This will make a window maintain an aspect ratio. The extra size allows a developer to have space, specified in pixels, not included within the aspect ratio calculations. This API already takes into account the difference between a window's size and its content size.

Controls whether to hide cursor when typing.

Sets whether the window menu bar should hide itself automatically. Once set the menu bar will only show when users press the single Alt key.

Examples of valid backgroundColor values:

This method sets the browser window's system-drawn background material, including behind the non-client area.

Resizes and moves the window to the supplied bounds. Any properties that are not supplied will default to their current values.

Sets whether the window can be manually closed by user. On Linux does nothing.

Resizes and moves the window's client area (e.g. the web page) to the supplied bounds.

Prevents the window contents from being captured by other apps.

Resizes the window's client area (e.g. the web page) to width and height.

Sets the content view of the window.

Specifies whether the window’s document has been edited, and the icon in title bar will become gray when set to true.

Disable or enable the window.

Changes whether the window can be focused.

Sets whether the window should be in fullscreen mode.

Sets whether the maximize/zoom window button toggles fullscreen mode or maximizes the window.

Sets whether the window should have a shadow.

Sets whether the window will be hidden when the user toggles into mission control.

Changes window icon.

Makes the window ignore all mouse events.

Enters or leaves kiosk mode.

Sets whether the window can be manually maximized by user. On Linux does nothing.

Sets the maximum size of window to width and height.

Sets the menu as the window's menu bar.

Sets whether the menu bar should be visible. If the menu bar is auto-hide, users can still bring up the menu bar by pressing the single Alt key.

Sets whether the window can be manually minimized by user. On Linux does nothing.

Sets the minimum size of window to width and height.

Sets whether the window can be moved by user. On Linux does nothing.

Sets the opacity of the window. On Linux, does nothing. Out of bound number values are clamped to the 0, 1 range.

Sets a 16 x 16 pixel overlay onto the current taskbar icon, usually used to convey some sort of application status or to passively notify the user.

Sets parent as current window's parent window, passing null will turn current window into a top-level window.

Moves window to x and y.

Sets progress value in progress bar. Valid range is 0, 1.0.

Sets the pathname of the file the window represents, and the icon of the file will show in window's title bar.

Sets whether the window can be manually resized by the user.

Setting a window shape determines the area within the window where the system permits drawing and user interaction. Outside of the given region, no pixels will be drawn and no mouse events will be registered. Mouse events outside of the region will not be received by that window, but will fall through to whatever is behind the window.

Changes the attachment point for sheets on macOS. By default, sheets are attached just below the window frame, but you may want to display them beneath a HTML-rendered toolbar. For example:

Enters or leaves simple fullscreen mode.

Resizes the window to width and height. If width or height are below any set minimum size constraints the window will snap to its minimum size.

Makes the window not show in the taskbar.

Whether the buttons were added successfully

Sets the region of the window to show as the thumbnail image displayed when hovering over the window in the taskbar. You can reset the thumbnail to be the entire window by specifying an empty region: { x: 0, y: 0, width: 0, height: 0 }.

Sets the toolTip that is displayed when hovering over the window thumbnail in the taskbar.

Changes the title of native window to title.

On a window with Window Controls Overlay already enabled, this method updates the style of the title bar overlay.

Raises browserView above other BrowserViews attached to win. Throws an error if browserView is not attached to win.

Sets the touchBar layout for the current window. Specifying null or undefined clears the touch bar. This method only has an effect if the machine has a touch bar.

Adds a vibrancy effect to the window. Passing null or an empty string will remove the vibrancy effect on the window.

Adds a vibrancy effect to the browser window. Passing null or an empty string will remove the vibrancy effect on the window.

Sets whether the window should be visible on all workspaces.

Set a custom position for the traffic light buttons in frameless window. Passing null will reset the position to default.

Sets whether the window traffic light buttons should be visible.

Shows and gives focus to the window.

Shows or hides the tab overview when native tabs are enabled.

Same as webContents.showDefinitionForSelection().

Shows the window but doesn't focus on it.

Toggles the visibility of the tab bar if native tabs are enabled and there is only one tab in the current window.

Unhooks all of the window messages.

Unhook the window message.

Unmaximizes the window.