play-selenium 0.0.3

Conditional commands (Javascript)

Based on a browser level expression (Javascript):

- type: clickElement
  provider: selenium
  locator:
    type: css
    value: body
  condition: "'$foo' === 'bar'"

Supported locators

Supported selector types:

• css

• xpath

• tag

• name

• text

• id

• value

Open a page

With parametrization:

- type: get
  provider: selenium
  url: "$base_url"

or with a regular url:

- type: get
  provider: selenium
  url: https://google.com

Pause

This command invokes a javascript expression that will pause the execution flow of your commands:

- type: pause
  provider: selenium
  waitTime: 1500

If you need a pause/sleep for non UI tests you can use the sleep command provided by the play_python plugin.

Click an element

- type: clickElement
  provider: selenium
  locator:
    type: css
    value: body

Fill in a text

- type: setElementText
  provider: selenium
  locator:
    type: css
    value: input.title
  text: text value

Interact with select input elements

Select by label:

- type: select
  provider: selenium
  locator:
    type: css
    value: select.city
  text: Turin

or select by value:

- type: select
  provider: selenium
  locator:
    type: css
    value: select.city
  value: '1'

Eval a Javascript expression

- type: eval
  provider: selenium
  script: alert('Hello world!')

Create a variable starting from a Javascript expression

The value of the Javascript expression will be stored in play.variables under the name count:

- type: storeEval
  provider: selenium
  variable: count
  script: document.getElementById('count')[0].textContent

Assert if a Javascript expression matches

If the result of the expression does not match an AssertionError will be raised and the test will fail:

- type: verifyEval
  provider: selenium
  value: '3'
  script: document.getElementById('count')[0].textContent

Verify that the text of one element contains a string

If the element text does not contain the provided text an AssertionError will be raised and the test will fail:

- type: verifyText
  provider: selenium
  locator:
    type: css
    value: ".my-item"
  text: a text

Send keys to an element

All selenium.webdriver.common.keys.Keys are supported:

- type: sendKeysToElement
  provider: selenium
  locator:
    type: css
    value: ".confirm"
  text: ENTER

Supported keys:

KEYS = [
    'ADD', 'ALT', 'ARROW_DOWN', 'ARROW_LEFT', 'ARROW_RIGHT',
    'ARROW_UP', 'BACKSPACE', 'BACK_SPACE', 'CANCEL', 'CLEAR',
    'COMMAND', 'CONTROL', 'DECIMAL', 'DELETE', 'DIVIDE',
    'DOWN', 'END', 'ENTER', 'EQUALS', 'ESCAPE', 'F1', 'F10',
    'F11', 'F12', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8',
    'F9', 'HELP', 'HOME', 'INSERT', 'LEFT', 'LEFT_ALT',
    'LEFT_CONTROL', 'LEFT_SHIFT', 'META', 'MULTIPLY',
    'NULL', 'NUMPAD0', 'NUMPAD1', 'NUMPAD2', 'NUMPAD3',
    'NUMPAD4', 'NUMPAD5', 'NUMPAD6', 'NUMPAD7', 'NUMPAD8',
    'NUMPAD9', 'PAGE_DOWN', 'PAGE_UP', 'PAUSE', 'RETURN',
    'RIGHT', 'SEMICOLON', 'SEPARATOR', 'SHIFT', 'SPACE',
    'SUBTRACT', 'TAB', 'UP',
]

Wait until a Javascript expression matches

Wait until the given expression matches or raise a selenium.common.exceptions.TimeoutException if takes too time.

At this time of writing there is a global timeout (20s) but in future releases you will be able to override it on command basis:

- type: waitUntilCondition
  provider: selenium
  script: document.body.getAttribute('class') === 'ready'

Wait for element present in DOM

Present:

- type: waitForElementPresent
  provider: selenium
  locator:
    type: css
    value: body

or not present:

- type: waitForElementPresent
  provider: selenium
  locator:
    type: css
    value: body
  negated: true

Wait for element visible

Visible:

- type: waitForElementVisible
  provider: selenium
  locator:
    type: css
    value: body

or not visible:

- type: waitForElementVisible
  provider: selenium
  locator:
    type: css
    value: body
  negated: true

Assert element is present in DOM

An AssertionError will be raised if assertion fails.

Present:

- type: assertElementPresent
  provider: selenium
  locator:
    type: css
    value: div.elem

or not present:

- type: assertElementPresent
  provider: selenium
  locator:
    type: css
    value: div.elem
  negated: true

Assert element is visible

An AssertionError will be raised if assertion fails.

Present:

- type: assertElementVisible
  provider: selenium
  locator:
    type: css
    value: div.elem

or not present:

- type: assertElementVisible
  provider: selenium
  locator:
    type: css
    value: div.elem
  negated: true

Changelog