active-win-url

Get metadata about the active window (URL, title, id, bounds, owner, etc). Works on macOS.

Usage no npm install needed!

<script type="module">
  import activeWinUrl from 'https://cdn.skypack.dev/active-win-url';
</script>

README

active-win-url Build Status

Get metadata about the active window (URL, title, id, bounds, owner, etc)

Works on macOS.

Users on macOS 10.13 or earlier needs to download the Swift runtime support libraries.

Install

$ npm install active-win-url

Usage

const activeWin = require('active-win-url');

(async () => {
    console.log(await activeWin());
    /*
    {
        title: 'Unicorns - Google Search',
        id: 5762,
        bounds: {
            x: 0,
            y: 0,
            height: 900,
            width: 1440
        },
        owner: {
            name: 'Google Chrome',
            processId: 310,
            bundleId: 'com.google.Chrome',
            path: '/Applications/Google Chrome.app'
        },
        url: 'https://google.com/unicorns',
        memoryUsage: 11015432
    }
    */
})();

API

activeWin()

Returns a Promise<Object> with the result, or Promise<undefined> if there is no active window or if the information is not available.

activeWin.sync()

Returns an Object with the result, or undefined if there is no active window.

Result

  • platform (string) - 'macos' | 'linux' | 'windows'
  • title (string) - Window title
  • id (number) - Window identifier
  • bounds (Object) - Window position and size
    • x (number)
    • y (number)
    • width (number)
    • height (number)
  • owner (Object) - App that owns the window
    • name (string) - Name of the app
    • processId (number) - Process identifier
    • bundleId (string) - Bundle identifier (macOS only)
    • path (string) - Path to the app
  • url (string) - URL of active window if browser
  • memoryUsage (number) - Memory usage by the window owner process

OS support

It works on macOS.

Related

Maintainers