- 2 minutes to read
The Statements category contains the following test actions.
Define Element Selector
The Define Element Selector action allows you to create an element selector that identifies a webpage element. You can define an element selector once and use it in the subsequent test actions. This makes your tests easier to read and maintain.
See Reuse Selectors for more information.
The Define Function action allows you to create a function that returns data from the tested webpage. You can then verify this data in assertions.
This type of function cannot return non-serializable objects (DOM elements,
window, etc.). Use element selectors instead.
To create a function:
Specify the function's name in the Name field.
Function names must be unique in a test. You also cannot use the following reserved words: t, fixture, test, Selector, ClientFunction, RequestLogger, RequestMock, and RequestHook.
Write the code. Use the
returnstatement to return the desired data.
The following image demonstrates how to define a function that returns the URL of the currently open page.
Then you can verify if the returned URL matches the expected URL using the Deep Equal assertion.
Limitations for Functions
- Defined functions cannot return non-serializable objects (DOM elements,
- Do not modify a tested webpage within functions. To interact with the webpage, use on-page actions.
You cannot use generators or
async/awaitsyntax within functions. To run asynchronous code, use a Promise within a function. The function is complete only when this Promise resolves.
You cannot use element selectors within functions.
- Currently, you cannot pass arguments to functions. The feature is in progress.