Skip to content

Latest commit

 

History

History
205 lines (119 loc) · 3.26 KB

2-Basic.md

File metadata and controls

205 lines (119 loc) · 3.26 KB
Raw

[Tree]

Basic Usage

You should run each operation in an individual test.

You can do combinations of operations in a single task, if it makes sense for you.

When using multiple operations in one task, they'll occure in the followinf order: resize --> url --> click --> script --> set --> get --> drag --> file --> alert --> frame --> sleep --> notify

NOTE: Be careful to NOT use an operation more than once in a task!

"url" - Go to the given url

Example:

- name: usually-the-first-task
  url: "http://example.com

"click" - Click an element that has a given CSS selector

Example 1:

- name: some-task
  click: "#wrap > h2:last-child" # Or any CSS selector

NOTE: If the element doesn't exist, the whole test will fail!

Example 2:

- name: some-other-task
  click: h1

"script" - Run custom script

Example 1:

- name: some-task
  script: "alert(22);"

Example 2:

This is test/sub/disable-alerts.yml which can be included (see, test/docs/3-Advanced.md) to disable some of the alerts for the test if needed.

- name: some-task
  script: "window.alert = window.confirm = window.prompt = window.onbeforeunload = function(str) { return true; };"

"set" - Set an element's value using a CSS selector

Example 1:

- name: some-set-task
  set: "input[type=\"email\"]"
  value: "[email protected]" # Required !!!

Example 2:

- name: some-other-set-task
  set: "#username"
  value: "John Doe" # Required !!!

"get" - Get an element's value using a CSS selector

Example 1:

- name: some-get-task
  get: "input[type=\"email\"]"
  expect: "to.be.visible" # Required !!!

Example 2:

- name: some-other-get-task
  get: "#username"
  expect: "to.have.count" # Required !!!
  value: 1 # (optional)

"drag" - Drag an element and Drop it on the given (selector or coordinate) value using (only) CSS selectors

Example 1:

- name: some-get-task
  drag: ".myImage"
  value: "#drop-area"

Example 2:

- name: some-other-get-task
  drag: ".myImage"
  value: 420x240

Example 3:

- name: some-other-get-task
  get: "#username"
  expect: "text" # Required !!!
  value: "John Doe" # (optional)

"alert" - Accept or cancel an alert dialog

Example:

- name: some-alert-task
  alert: true

"frame" - Switch to frame with given ID

Example:

- name: some-frame-task
  frame: "frame-id" # You can set an ID if such doesn't exist, with "script"

"sleep" - Sleep for a given number of seconds

Example:

- name: some-sleep-task
  sleep: 3 # This will sleep for 3 seconds.

"notify" - A webhook url (POST)

Example 1:

- name: some-task-87
  get: "#username"
  expect: "text"
  value: "John Doe"
  notify: "http://example.com" # This will send the result status of this step

NOTE: This notification will be send even if the previous tasks fail.

Example 2:

- name: some-notift-task
  notify: "http://example.com" # This will send the overall status (at this point)

[Source]