User Interface "Navigation" Commands
These commands allow you to implement actions like:
- Going back from one page (screen) to the previous
- Going forward from one page to the next
- Refreshing the current web page
- Opening a web application
- Open a new browser window
- Selecting a frame or window, etc.
The Navigation commands have the smallest set of commands.
The table(s) below lists the commands in the ascending alphabetic order within each category along with a brief description of the purpose of the command. By clicking on the hyperlinked command name in the table(s) below, you can review more detailed information about a specific command that includes the syntax for you to follow when using the commands.
You can visit Commands for Native/Hybrid Mobile User Interface, to find the powerful command set that Worksoft SaaS has, to automate your Native/Hybrid Mobile Apps.
| Command | Purpose |
|---|---|
| goBack | Simulates the user clicking the 'back' button on their browser. |
| goBackAndWait | Simulates the user clicking the 'back' button on their browser. |
| open | Opens an URL in the test frame. This accepts both relative and absolute URLs. The open command waits for the page to load before proceeding, ie. the AndWait suffix is implicit. Note: The URL must be on the same domain as the runner HTML due to security restrictions in the browser (Same Origin Policy). If you need to open an URL on another domain, use the Selenium Server to start a new browser session on that domain. |
| openWindow | Opens a popup window (if a window with that ID isn't already open). After opening the window, you'll need to select it using the selectWindow command.This command can also be a useful workaround for bug SEL-339. In some cases, Selenium will be unable to intercept a call to window.open (if the call occurs during or before the onLoad event, for example). In those cases, you can force Selenium to notice the open window's name by using the Selenium openWindow command, using an empty (blank) URL, like this: openWindow(, myFunnyWindow). Care must be taken while giving Window URL because Window URL should not contain any spaces or special characters in Internet Explorer Browser. It is a good practice to use Window URL without spaces and special characters across all browsers. |
| refresh | This command is used to refresh/reload the page after performing certain actions.Simulates the user clicking the "Refresh" button on their browser. |
| refreshAndWait | This command is used to refresh/reload and wait till the page loads after performing certain actions on the page. The default wait time in Worksoft SaaS is 120 seconds.Simulates the user clicking the "Refresh" button on their browser. |
| selectFrame | Selects a frame within the current window. (You may invoke this command multiple times to select nested frames.) To select the parent frame, use relative=parent as a locator; to select the top frame, use relative=top. You can also select a frame by its 0-based index number; select the first frame with index=0 or the third frame with index=2. |
| selectWindow | Window locators provide different ways of specifying the window object: by title, by internal JavaScript "name," or by JavaScript variable. |