Retrieve tabs/windows
Retrieve the tabs and windows currently available in an existing browser session. The result includes the title, current URL, 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, and current URL | 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/"
},
{
"contextIndex": 0,
"pageIndex": 1,
"title": "Login",
"url": "https://example.com/login"
}
]
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