Guide

Codeless Load Generator

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 
---
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.

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.

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 
---
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.

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 
---
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.

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 
---
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.

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 
---
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.

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 
---
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.

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 
---
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. 
---
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.

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 
---
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.

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'

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. 
---
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.

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 
---
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. 
---
loadGenerator:
  ...
suites:
  Your Suite Name:
    ...
    steps:
      Your Step Name:
        - sleep: 3.5s
        - sleep: 5s-10s
Previous Chapter: Browser Clouds
Next Chapter: Embedded Load Generator