Below are common examples of window functionalities:

await eagle.window.show();            // Show plugin window
await eagle.window.hide();            // Hide plugin window

await eagle.window.minimize();        // Minimize window
await eagle.window.restore();         // Restore minimized

await eagle.window.maximize();        // Maximize window
await eagle.window.unmaximize();      // Restore maximized

await eagle.window.setFullScreen(true);       // Set to fullscreen
await eagle.window.setFullScreen(false);      // Exit fullscreen

Methods

show()

Show and focus the window.

• Returns Promise<>

await eagle.window.show();

showInactive()

Show the window but don't focus on it.

• Returns Promise<>

hide()

Hide the plugin window.

• Returns Promise<>

focus()

Give the plugin window focus.

• Returns Promise<>

minimize()

Minimize the plugin window.

• Returns Promise<>

isMinimized()

Determine if the window is minimized.

• Returns Promise<minimized: boolean>

  • minimized boolean - Whether the window is minimized

restore()

Restore the plugin window from a minimized state to its previous state.

• Returns Promise<>

maximize()

Maximize the plugin window. If the window has not yet been displayed, this method will also show it (but not focus on it).

• Returns Promise<>

unmaximize()

Unmaximize the plugin window.

• Returns Promise<>

isMaximized()

Determine if the window is maximized.

• Returns Promise<maximized: boolean>

  • maximized boolean - Whether the window is maximized

setFullScreen(flag)

Set whether the window should be in fullscreen mode.

• flag boolean - Whether to set as fullscreen

• Returns Promise<>

isFullScreen()

Determine if the window is in fullscreen mode.

• Returns Promise<fullscreen: boolean>

  • fullscreen boolean - Whether the window is in fullscreen

setAspectRatio(aspectRatio)

This will make the window maintain its aspect ratio.

• aspectRatio Float - The aspect ratio to maintain (width / height)

• Returns Promise<>

setBackgroundColor(backgroundColor)

Set the background color of the window.

• backgroundColor String - This parameter represents the HEX code of your desired background color.

• Returns Promise<>

setSize(width, height)

Set window size.

• width Integer - window width

• height - Integer - window height

• Returns Promise<>

getSize()

Get window size.

• Returns Promise<Integer[]>

setBounds(bounds)

Adjust the window size and move it to the provided bounds. Any properties not provided will default to their current values.

getBounds()

Get window bounds.

• Returns Promise<Rectangle[]> - object representing the window bounds

setResizable(resizable)

Set whether the window supports resizing.

• resizable boolean - whether resizing is supported

• Returns Promise<>

isResizable()

Whether the window supports resizing.

• Returns Promise<resizable: boolean>

  • resizable boolean

setAlwaysOnTop(flag)

Set whether the window should always be displayed in front of other windows.

• flag boolean

• Returns Promise<>

isAlwaysOnTop()

Whether the window should always be displayed in front of other windows.

• Returns Promise<alwaysOnTop: boolean>

  • alwaysOnTop boolean

setPosition(x, y)

Move the window to x and y.

• x Integer

• y Integer

• Returns Promise<>

getPosition()

Get plugin window coordinates x and y.

• Returns Promise<position: Integer[]>

  • position Integer[]

    • x - position[0]

    • y - position[1]

setOpacity(opacity)

Set the opacity of the window, values outside the range are limited to the [0, 1] range.

• opacity number - between 0.0 (completely transparent) and 1.0 (completely opaque)

• Returns Promise<>

getOpacity()

Get window opacity, between 0.0 (completely transparent) and 1.0 (completely opaque).

• Returns Promise<opacity: number>

  • opacity number

flashFrame(flag)

Start or stop flashing the window to attract the user's attention.

• flag boolean - whether to flash

• Returns Promise<>

setIgnoreMouseEvents(ignore)

Ignore all mouse events within the window. All mouse events occurring in this window will be passed to the window below it but if this window has focus, it will still receive keyboard events.

• ignore boolean - whether to ignore mouse events

• Returns Promise<>

capturePage(rect)

Capture a snapshot of the page within the specified rect area. Omitting rect will capture the entire visible page.

• rect object - Optional, screenshot range

  • x number

  • y number

  • width number

  • height number

• Returns Promise<[NativeImage](https://www.electronjs.org/docs/latest/api/native-image)>

setReferer(url)

Sets the current referer URL. Once set, subsequent requests will utilize this referer.

• url string - The URL of the referer.

• Returns void