action: open
Action to open specified URL in the current browser window.
Default timeout to open the page is 30s.
An action fails if such a timeout is reached, but a page is still loading.
This action supports extended syntax with two dedicated properties:
- url - URL of the page to open
- timeout - timeout to await page load
- url - URL of the page to open
- timeout - timeout to await page load
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- open: https://example.com
- open:
url: https://example.com
timeout: 15.5s
action: awaitPageLoad
Action to await page load event in the current browser window.
Parameter of this action specifies how much time to wait till load
event occurs, before giving up and throwing an exception
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitPageLoad: 5s
action: awaitElementToBeVisible
Action to await element to be visible on the page of the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Element is visible when it is present in the DOM tree of the page and
it is visible.
Visibility means that the element is not only displayed but also has a height and width that is greater than 0.
Visibility means that the element is not only displayed but also has a height and width that is greater than 0.
Default timeout to await element to be visible is 30s.
An action fails if such a timeout is reached, but specified element
is not visible yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitElementToBeVisible: 'input[type=submit]'
- awaitElementToBeVisible:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- awaitElementToBeVisible:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: awaitElementToBeClickable
Action to await element to be clickable on the page of the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Element is clickable when it is visible on the page, it is enabled,
and you can click on it.
Default timeout to await element to be clickable is 30s.
An action fails if such a timeout is reached, but specified element
is not clickable yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be clickable
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be clickable
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitElementToBeClickable: 'input[type=submit]'
- awaitElementToBeClickable:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- awaitElementToBeClickable:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: awaitElementToBeDisabled
Action to await element to be disabled on the page of the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Element is disabled when it is present in the DOM tree,
it is visible, and it has a disabled attribute turned on.
Typically this is html input element.
Default timeout to await element to be disabled is 30s.
An action fails if such a timeout is reached, but specified element
is not disabled yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be disabled
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be disabled
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitElementToBeDisabled: 'input[type=submit]'
- awaitElementToBeDisabled:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- awaitElementToBeDisabled:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: awaitElementToBeEnabled
Action to await element to be enabled on the page of the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Element is enabled when it is present in the DOM tree,
it is visible, and it has no disabled attribute.
Default timeout to await element to be enabled is 30s.
An action fails if such a timeout is reached, but specified element
is not enabled yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be enabled
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be enabled
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitElementToBeEnabled: 'input[type=submit]'
- awaitElementToBeEnabled:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- awaitElementToBeEnabled:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: awaitElementToBeInvisible
Action to await element to be invisible on the page of the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Element is invisible when it is either invisible or not present in the DOM tree.
Default timeout to await element to be invisible is 30s.
An action fails if such a timeout is reached, but specified element
is not invisible yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be invisible
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be invisible
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitElementToBeInvisible: 'input[type=submit]'
- awaitElementToBeInvisible:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- awaitElementToBeInvisible:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: awaitAlertToBePresent
Action to await alert to be present in the current browser window.
Parameter of this action specifies how much time to wait till alert is shown,
before giving up and throwing an exception
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- awaitAlertToBePresent: 5s
action: click
Action to click on the element in the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Click action can be performed only on clickable elements,
so as a prerequsite, an action waits till element is present in the DOM tree,
it is visible and enabled.
Default timeout to await element to be clickable is 30s.
An action fails if such a timeout is reached, but specified element
is not clickable yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be clickable
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be clickable
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- click: 'input[type=submit]'
- click:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- click:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: closeAlert
Action to close an alert shown in the current browser window.
Parameter of this action specifies alert button to click.
It can be either 'ok' or 'cancel'.
Close alert action can be performed only when an alert is shown,
so as a prerequisite, an action waits till alert is present.
Default timeout to await alert to be shown is 30s.
An action fails if such a timeout is reached, but an alert is not present yet.
There are some cases, when an alert has an input field,
so a user should enter a text. You can use extended syntax to send a text alongside closing the alert.
This action supports extended syntax with three dedicated properties:
- action - css selector to find element.
- text - optional text to submit while closing the alert.
- timeout - timeout to await alert to be present.
- action - css selector to find element.
- text - optional text to submit while closing the alert.
- timeout - timeout to await alert to be present.
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- closeAlert: ok
- closeAlert:
action: ok
timeout: 15.5s
- closeAlert:
action: cancel
text: your text
timeout: 15.5s
action: focus
Action to focus on the element in the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Focus action can be performed only on visible elements,
so as a prerequsite, an action waits till element is present in the DOM tree
and it is visible.
Default timeout to await element to be visible is 30s.
An action fails if such a timeout is reached, but specified element
is not visible yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- focus: 'input[type=submit]'
- focus:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- focus:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: input
Action to enter text into input element of the current browser window.
This action has two required parameters:
- either cssSelector or xpathSelector, selector of the element where to enter text.
- value, actual text to enter into the input element.
- either cssSelector or xpathSelector, selector of the element where to enter text.
- value, actual text to enter into the input element.
Such action can also be used to upload files when target input element has type="file".
To do so, please specify path to the file you would like to upload in the 'value' property,
for example:
value: './path/to/file/for/upload.json'
value: './path/to/file/for/upload.json'
Input action can be performed only on clickable elements,
so as a prerequsite, an action waits till element is present in the DOM tree,
it is visible and enabled.
Default timeout to await element to be clickable is 30s.
An action fails if such a timeout is reached, but specified element
is not clickable yet.
This action supports extended syntax with three dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- value - text to enter into the input field.
- timeout - timeout to await element to be clickable.
- either cssSelector or xpathSelector - selector to find element
- value - text to enter into the input field.
- timeout - timeout to await element to be clickable.
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- input:
cssSelector: 'input[type=password]'
value: 'your_secured_password'
- input:
cssSelector: 'input[type=password]'
value: 'your_secured_password'
timeout: 30s
- input:
xpathSelector: '//[@type="password"]'
value: 'your_secured_password'
timeout: 15.5s
action: scroll
Action to scroll till the element in the current browser window.
Parameter of this action specifies selector for the element to find
in the DOM tree of the page.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
By default, load-generator uses 'css' selectors, but you can switch default and global behavior to use 'xpath' based selectors via changing defaultSelectorType property of the load-generator.
Scroll action can be performed only on visible elements,
so as a prerequsite, an action waits till element is present in the DOM tree
and it is visible.
Default timeout to await element to be visible is 30s.
An action fails if such a timeout is reached, but specified element
is not visible yet.
This action supports extended syntax with two dedicated properties:
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
- either cssSelector or xpathSelector - selector to find element
- timeout - timeout to await element to be visible
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- scroll: 'input[type=submit]'
- scroll:
cssSelector: 'input[type=submit]'
timeout: 15.5s
- scroll:
xpathSelector: '//[@type="submit"]'
timeout: 15.5s
action: sleep
Action to postpone any activities according to specified duration.
Parameter of this action specifies duration to sleep.
Sleep action supports randomization,
so you can use the following construct to introduce random
sleeping within specific range:
sleep: 5s-10s
Actual value would be randomly picked at the time of the action processing.
sleep: 5s-10s
Actual value would be randomly picked at the time of the action processing.
---
loadGenerator:
...
suites:
Your Suite Name:
...
steps:
Your Step Name:
- sleep: 3.5s
- sleep: 5s-10s