Skip to main content

List Windows

Retrieves the titles of all open browser windows and tabs as an array.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing the node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If Continue On Error property is true, no error is caught when the project is executed, even if the Catch node is used.

Input​

  • Browser ID - The browser session identifier from the Open Browser node.

Output​

  • Window Titles - Array of window titles from all open browser tabs, in the order they were opened.

Examples​

Get All Window Titles​

Browser ID: {{browser_id}}
Output: {{windows}}

Result: ["Main Page", "Dashboard", "Settings - App"]

Check for Specific Window​

1. List Windows node:
   Browser ID: {{browser_id}}
   Output: {{titles}}

2. Condition: if {{titles}} contains "Login"

Count Open Windows​

1. List Windows node:
   Browser ID: {{browser_id}}
   Output: {{windows}}

2. Get array length: {{windows.length}}

Find and Switch to Window​

1. List Windows node:
   Browser ID: {{browser_id}}
   Output: {{windows}}

2. For Each {{windows}} as {{window_title}}:

   If {{window_title}} contains "Dashboard":
     Switch Window:
       Browser ID: {{browser_id}}
       Window Name: {{window_title}}

Log All Open Windows​

1. List Windows node:
   Browser ID: {{browser_id}}
   Output: {{titles}}

2. For Each {{titles}}:
   Log: "Window: {{title}}"

Tips​

  • Use before Switch Window to verify window titles
  • Helpful for debugging multi-window scenarios
  • The current window remains active after listing
  • Window order matches the order they were opened
  • Use in conditional logic to handle different window states
  • Combine with loops to process all windows

Common Errors​

  • "Browser ID cannot be empty" - Connect to an Open Browser node
  • "Browser session not found" - Ensure the Open Browser node has run successfully