Retrieve tabs/windows
Retrieve the tabs and windows currently available in an existing browser session. The result includes the title, current URL, active/focused state, and page identifiers that can be used by subsequent Web Automation Wrk Actions.
Application
- Web - Sessions
Inputs (what you have)
| Name | Description | Data Type | Required? | Example |
|---|---|---|---|---|
| Browser session ID | The unique identifier of the browser instance. Can be retrieved from "Open web session" Wrk Action | Text (Short) | Yes | fb9bc380-146c-420e-9130-50ce93614e05 |
Note: the value of inputs can either be a set value in the configuration of the Wrk Action within the Wrkflow, or a variable from the Data Library section. These variables in the Data Library section are the outputs of previous Wrk Actions in the Wrkflow.
Outputs (what you get)
| Name | Description | Data Type | Required? | Example |
|---|---|---|---|---|
| Browser tabs | JSON list containing each currently available page. Each item should include the browser context index, page index, page/tab title, current URL, and whether the page is currently active/focused | Text (Long) | Yes | |
| Unsuccessful message | If unsuccessful, a message stating what went wrong | Text (Long) | No | |
| Unsuccessful screenshot | If unsuccessful, a screenshot of the website | File | No |
Example Tabs / windows JSON:
[
{
"contextIndex": 0,
"pageIndex": 0,
"title": "Wrk",
"url": "https://www.wrk.com/",
"isActive": true
},
{
"contextIndex": 0,
"pageIndex": 1,
"title": "Login",
"url": "https://example.com/login",
"isActive": false
}
]
Outcomes
| Name | Description |
|---|---|
| Success | This status is selected when the list of tabs/windows was retrieved successfully (including an empty list) |
| Unsuccessful | This status is selected when an error occurred while retrieving tabs/windows from the provided browser session |
| Impossible to complete | This status is selected when unable to connect to the session |
Requirements
- N/A