Browser Actions › Actions › Get Browser Windows (β)

Returns the windows that fulfill the specified criteria. Filtering is additive, i.e. windows must meet all enabled filter criteria to be included in the results.

Parameters

Browser

The browser to work with.

Selecting "frontmost browser" will only work if the application currently in the foreground is a supported browser.

Type: Browser

Which window

By default, all windows are returned. It’s also possible to only return the first, the last, or a random window, if you so choose.

The order of the windows is returned by macOS in 'front to back' direction. This means that choosing "the first window" will return the frontmost window for the selected browser, while "the last window" will return the bottom window in the stack.

Options:

• all windows
• the first window
• the last window
• a random window

Filter by window type

Enables filtering windows by their privacy level, i.e. you can set the action to only return standard windows, or only private ones.

Options:

• no
• standard windows only
• private windows only

Filter by window title

Enables filtering the results by window title.

Example, for a window title "ActionsDotWork.", and Title filter string "action":

• "it should contain …" would return a match
• "it should contain … (case-sensitive)" would not return a match, because "action" and "Action" are not identical
• "it should be exactly …" would not return a match, because the window title is not "action".

Options:

• no
• it should contain …
• it should contain … (case-sensitive)
• it should be exactly …

Title filter string

Filter the results by this title string as specified by Filter by window title.

Type: Text

Filter by visibility

Enables filtering the result by window visibility.

Options:

• no
• visible windows only
• hidden or minimized windows only

Return Value

Browser Window (list)

Related Links

• Search the Browser Actions community forum for "Get Browser Windows (β)"