--- title: "Web Testing - Action Documentation" slug: "web-testing-action-documentation" description: "Web Testing - Action Documentation for Test Modeller" tags: ["Test Automation", "Test Modeller"] updated: 2024-09-27T14:14:11Z published: 2024-09-27T14:14:11Z --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.curiositysoftware.ie/llms.txt > Use this file to discover all available pages before exploring further. # Web Action Documentation Web actions are exposed in the Web Automation framework in Quality Modeller. The corresponding Git repository is available [**https://github.com/CuriositySoftwareIreland/TestModeller-JavaSeleniumFramework**](https://github.com/CuriositySoftwareIreland/TestModeller-JavaSeleniumFramework) . This uses Selenium with Java as the underlying automation technology. When the framework is imported into Quality Modeller, the actions below are available in the 'WebGeneralActions' module. This provides an accelerator for automating common actions on web devices. This class can be extended to incorporate your own keywords and actions as necessary. [Embedded content](https://www.youtube.com/embed/fePk_E8v0gk?&wmode=opaque&rel=0) **QuickStart Web Test Automation** To learn how you can quickly get started with Web Automation in Quality Modeller, check out our QuickStart guide: [**QuickStart Web Automation**](/docs/quickstart-web-automation) --- ## Location Strategy All keywords in the Quality Modeller WebGeneralActions library that need to find an element on the page take a locator argument. Locator is a string that describes how to locate an element using a syntax specifying different location strategies. | **Strategy** | **Example** | | --- | --- | | XPath | xpath://input[id="username"] | | Id | id:usernameId | | Class | class:username | | Css | css:#usernameId | | name | accessibilityId:usernameObj | | linktext | linktext:login | | text | text:inputusername | | tagname | tagname:button | --- ## Web Actions | #### Add Cookie (String name, String value) **Arguments** *name - Name of the cookie* *value - Value of the cookie* **Documentation** Adds a cookie to your current session. | | --- | | #### Alert Should Be Present **Documentation** Verifies that an alert is present. | | --- | | #### Alert Assert Text (String text) **Arguments** *text - Text to assert in the alert message.* **Documentation** Verifies that an alert is present and contains the specified text. | | --- | | #### Checkbox Should Be Selected (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies checkbox locator is selected/checked. | | --- | | #### Checkbox Should Not Be Selected (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies checkbox locator is not selected/checked. | | --- | | #### Clear Element Text (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Clears the value of the text-input-element identified by locator. | | --- | | #### Assert Current Frame Contains (String text) **Arguments** *Text - Text to assert the frame contains.* **Documentation** Verifies that the current frame contains text. | | --- | | #### Assert Current Frame Does Not Contain (String text) **Arguments** *text - Text to assert the frame does not contain.* **Documentation** Verifies that the current frame does not contain text. | | --- | | #### Delete All Cookies **Documentation** Deletes all cookies. | | --- | | #### Delete Cookie (String name) **Arguments** *name - Name of the cookie to delete.* **Documentation** Deletes the cookie matching name. | | --- | | #### Drag And Drop (String fromLocator, String targetLocator) **Arguments** *fromLocator - The object identifier to drag from. See locator strategy above.* *toLocator - The object identifier to drag to. See locator strategy above.* **Documentation** Drags the element identified by locator into the target element. The locator argument is the locator of the dragged element and the target is the locator of the target. | | --- | | #### Drag And Drop By Offset (String objectLocator, Integer xPos, Integer yPos) **Arguments** *objectLocator - The object identifier of the object to drag. See locator strategy above.* *xPos - X offset to perform drag.* *yPos - Y offset to perform drag* **Documentation** Drags the element identified with locator by xoffset/yoffset. The element will be moved by xPos and yPos, each of which is a negative or positive number specifying the offset. | | --- | | #### Element Attribute Value Should Be (String objectLocator, String elementAttribute, String attributeValue) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *elementAttribute - Element attribute to retrieve value.* *elementValue - Value to check element attribute is set to.* **Documentation** Verifies element identified by locator contains expected attribute value. | | --- | | #### Element Should Be Disabled (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that element identified by locator is disabled. | | --- | | #### Element Should Be Enabled (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that element identified by locator is enabled. | | --- | | #### Element Should Be Focused (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that element identified by locator is focused. | | --- | | #### Element Should Be Visible (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that the element identified by locator is visible. | | --- | | #### Element Should Contain (String objectLocator, String message) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *message - Message to check element contains* **Documentation** Verifies that element locator contains text expected. | | --- | | #### Element Should Not Be Visible (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that the element identified by locator is NOT visible. | | --- | | #### Element Should Not Contain (String objectLocator, String message) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *message - Message to check element does not contain.* **Documentation** Verifies that element locator does not contain text expected. | | --- | | #### Element Text Should Be (String objectLocator, String text) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *text - Text element should be set to.* **Documentation** Verifies that element locator contains exact the text expected. | | --- | | #### Element Text Should Not Be (String objectLocator, String text) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *text - Text element should not be set to.* **Documentation** Verifies that element locator does not contain exact the text not_expected. | | --- | | #### Execute Javascript (String javaScript) **Arguments** *javaScript - Javascript code to execute.* **Documentation** Executes the given JavaScript code with possible arguments. | | --- | | #### Frame Should Contain (String objectLocator, String text) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *text - Text to check frame contains.* **Documentation** Verifies that frame identified by locator contains text. | | --- | | #### Get Element Attribute (String objectLocator, String attribute) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *attribute - Attribute value to return* **Documentation** Returns the value of attribute from the element locator. | | --- | | #### Get Text (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Returns the text value of the element identified by locator. | | --- | | #### Get Title **Documentation** Returns the title of the current page. | | --- | | #### Get Value (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Returns the value attribute of the element identified by locator. | | --- | | #### Go Back **Documentation** Simulates the user clicking the back button on their browser. | | --- | | #### Accept Alert **Documentation** Accepts the alert. | | --- | | #### Dismiss Alert **Documentation** Dismisses the alert. | | --- | | #### Input Text Into Alert (String text) **Arguments** *Text - Text to input into alert message.* **Documentation** Types the given text into an input field in an alert. | | --- | | #### Mouse Down (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Simulates pressing the left mouse button on the element locator. | | --- | | #### Mouse Out (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Simulates moving the mouse away from the element locator. | | --- | | #### Mouse Over (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Simulates hovering the mouse over the element locator. | | --- | | #### Mouse Up (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Simulates releasing the left mouse button on the element locator. | | --- | | #### Open Context Menu (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Opens the context menu on the element identified by locator. | | --- | | #### Page Should Contain Text (String text) **Arguments** *text - Text the page should contain* **Documentation** Verifies that current page contains text. | | --- | | #### Page Should Contain Element (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that element locator is found on the current page. | | --- | | #### Page Should Not Contain Text (String text) **Arguments** *text - Text that the page should not contain.* **Documentation** Verifies that current page does not contain text. | | --- | | #### Page Should Not Contain Element (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Verifies that element locator is not found on the current page. | | --- | | #### Radio Button Should Be Set To (String groupName, String value) **Arguments** *groupName - Name of the radio group* *value - Value of the selected radio button.* **Documentation** Verifies radio button group group_name is set to value. | | --- | | #### Radio Button Should Not Be Selected (String groupName, String value) **Arguments** *groupName - Name of the radio group* *value - Value of the unselected radio button.* **Documentation** Verifies radio button group group_name has no selection. | | --- | | #### Reload Page **Documentation** Simulates user reloading page. | | --- | | #### Scroll Element Into View (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Scrolls the element identified by locator into view. | | --- | | #### Select All From List (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Selects all options from multi-selection list locator. | | --- | | #### Select Checkbox (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Selects the checkbox identified by locator. Does nothing if checkbox is already selected. | | --- | | #### Select From List By Index (String objectLocator, Integer index) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *index - Index of the list item to select.* **Documentation** Selects options from selection list locator by indexes. | | --- | | #### Select From List By Label (String objectLocator, String label) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *label - Label of the list item to select.* **Documentation** Selects options from selection list locator by labels. | | --- | | #### Select From List By Value (String objectLocator, String value) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *value - Value of the list item to select.* **Documentation** Selects options from selection list locator by values. | | --- | | #### Select Radio Button (String groupName, String value) **Arguments** *groupName - Name of the radio button group.* *value - Value to select.* **Documentation** Sets the radio button group group_name to value. | | --- | | #### Submit Form (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Submits a form identified by locator. | | --- | | #### Title Should Be (String value) **Arguments** *value - Title of the page should be.* **Documentation** Verifies that the current page title equals title. | | --- | | #### Unselect All From List (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Unselects all options from multi-selection list locator. | | --- | | #### Unselect Checkbox (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Removes the selection of checkbox identified by locator. | | --- | | #### Unselect From List By Index (String objectLocator, Integer index) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *index - Index of the list item to unselect.* **Documentation** Unselects options from selection list locator by indexes. | | --- | | #### Unselect From List By Label (String objectLocator, String label) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *label - Label of the list item to unselect.* **Documentation** Unselects options from selection list locator by labels. | | --- | | #### Unselect From List By Value (String objectLocator, String value) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *value - Value of the list item to unselect.* **Documentation** Unselects options from selection list locator by values. | | --- | | #### Wait Until Element Is Enabled (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Waits until the element locator is enabled. | | --- | | #### Wait Until Element Is Not Visible (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Waits until the element locator is not visible. | | --- | | #### Wait Until Element Is Visible (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Waits until the element locator is visible. | | --- | | #### Wait Until Page Contains Element (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Waits until the element locator appears on the current page. | | --- | | #### Switch Tab **Arguments** *tabIndex - Index of the tab to switch to.* **Documentation** Switch tab by index. Index 0 is always the main window. | | --- | | #### New Window **Documentation** Opens a new browser window / tab. | | --- | | #### Open URL (String url) **Arguments** *url - Url to open in the browser.* **Documentation** Navigates the current browser window to the provided url. | | --- | | #### Click (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Click the element identified by locator. | | --- | | #### Enter Text (String objectLocator, String text) **Arguments** *objectLocator - The object identifier. See locator strategy above.* *text - Text to input into the object.* #### **Documentation** Types the given text into the element identified by locator. | | --- | | #### Double Click (String objectLocator) **Arguments** *objectLocator - The object identifier. See locator strategy above.* **Documentation** Double clicks the element identified by locator. | | --- | Quality Modeller is Curiosity's flow-driven model-based tool which provides a range of accelerators and connectors for building flowcharts rapidly. Align all stakeholders to quality outcomes and create critical assets early, delivering superior software at speed. ## Related - [Automating Tests](/automating-and-executing-tests-in-test-modeller.md) - [QuickStart Web Automation](/quickstart-web-automation.md)