JsGetWindow

A cross-platform module designed for retrieving GUI information and managing application windows. Inspired from the pyGetWindow module.

Still under development. Currently only the Windows platform is implemented.

Installation

Install jsGetWindow with npm

  npm i jsgetwindow

API Reference

Functions

Function Name	Output	Description
getAllTitles()	String[]	Retrieves titles of all visible windows.
getAllWindows()	BaseWindow[]	Retrieves details of all visible windows.
getActiveWindow()	BaseWindow	Retrieves details of the currently active window.
getActiveWindowTitle()	String	Retrieves the title of the currently active window.
getCursorPosition()	{ x: number, y: number }	Retrieves the position of the cursor.
getWindowsAt(x:number, y:number)	BaseWindow[]	Retrieves details of windows at the given coordinates.
getWindowsWithTitle(title:String)	BaseWindow[]	Retrieves details of windows with the specified title.

Window Methods:

const window = getActiveWindow(); //BaseWindow object
window.close();

Method	Description
close()	Closes the window.
minimize()	Minimizes the window.
maximize()	Maximizes the window.
restore()	Restores the window.
show()	Shows the window.
hide()	Hides the window.
focus()	Focuses on the window.
resizeTo(width:number, height:number)	Resizes the window to the given width and height.
resizeOffset(widthOffset:number, heightOffset:number)	Resizes the window by the given width and height offsets.
moveTo(x:number, y:number)	Moves the window to the given x, y coordinates.
moveOffset(xOffset:number, yOffset:number)	Moves the window by the given x, y offsets.

Window Properties

const window = getActiveWindow(); //BaseWindow object
console.log(window.isActive); // true

Property	Output	Description
resolution	{ width: number, height: number }	Gets the resolution of the window (width, height).
x	number	Gets the x coordinate of the window.
y	number	Gets the y coordinate of the window.
isMaximized	boolean	Checks if the window is maximized.
isMinimized	boolean	Checks if the window is minimized.
isActive	boolean	Checks if the window is active.
isVisible	boolean	Checks if the window is visible.

BaseWindow object

{

    title: String,
    rect: Rect {
        left: number,
        top: number,
        right: number,
        bottom: number
    },
    handle: number

}

Function Example

> const gw = require("jsGetWindow");
undefined

> gw.getAllTitles();
[ 'new.js - test - Visual Studio Code',  'readme.so - Google Chrome', 'main.js - libProj - Visual Studio Code', 'Hannibal (2013) - S01E12 - Relevés (1080p BluRay x265 RCVR).mkv - PotPlayer', 'Realtek Audio Console', 'Command Prompt - py  reader1.py',  'Settings',  'Settings', 'Windows Input Experience' 'Program Manager' ]

> gw.getActiveWindow()
BaseWindow {
  title: 'new.js - test - Visual Studio Code',
  rect: Rect { left: -7, top: -7, right: 1714, bottom: 920 },
  handle: 328462
}

> gw.getWindowsWithTitle("chrome")
[
BaseWindow {
    title: 'woustachemaxd/JsGetWindow - Google Chrome',
    rect: Rect { left: -7, top: -7, right: 1714, bottom: 920 },
    handle: 198404
  },
    BaseWindow {
    title: 'Toby - Google Chrome',
    rect: Rect { left: -7, top: -7, right: 1714, bottom: 920 },
    handle: 2361776
  }
]

> gw.getActiveWindow().title
'new.js - test - Visual Studio Code'

> gw.getAllWindows();
[
  BaseWindow {
    title: 'new.js - test - Visual Studio Code',
    rect: Rect { left: -7, top: -7, right: 1714, bottom: 920 },
    handle: 328462
  },
  BaseWindow {
    title: 'readme.so - Google Chrome',
    rect: Rect { left: -7, top: -7, right: 1714, bottom: 920 },
    handle: 198404
  },
    ...
  BaseWindow {
    title: 'Program Manager',
    rect: Rect { left: 0, top: 0, right: 1707, bottom: 960 },
    handle: 65942
  }
]

>

Method and Properties Example

> chromeWindow = gw.getWindowsWithTitle("chrome")[0]
> chromeWindow.isMaximized
False
> chromeWindow.maximize()
> chromeWindow.isMaximized
True
> chromeWindow.minimize()
> chromeWindow.restore()
> chromeWindow.activate()
> chromeWindow.resizeOffset(10, 10) # increase by 10, 10
> chromeWindow.resizeTo(100, 100) # set size to 100x100
> chromeWindow.moveOffset(10, 10) # move 10 pixels right and 10 down
> chromeWindow.moveTo(10, 10) # move window to 10, 10
> chromeWindow.close()