Skip to content

Latest commit

 

History

History
199 lines (122 loc) · 5.67 KB

canned_steps.md

File metadata and controls

199 lines (122 loc) · 5.67 KB

Canned steps

Calabash Android comes with the following set of predefined steps. You can add you own steps or change the ones you see here.

Assertion steps

To assert that specified text can be found use any of the following steps.

Then /^I see the text "([^\"]*)"$/
Then /^I see "([^\"]*)"$/
Then /^I should see "([^\"]*)"$/
Then /^I should see text containing "([^\"]*)"$/

To assert that specified text cannot be found use any of the following steps.

Then /^I should not see "([^\"]*)"$/
Then /^I don't see the text "([^\"]*)"$/
Then /^I don't see "([^\"]*)"$/

Input steps

Then /^I toggle checkbox number (\d+)$/ do |checkboxNumber|

Toggles checkout with the specified index.

Then /^I long press "([^\"]*)"$/ do |text_to_press|

Long presses the text if found.

Then /^I long press "([^\"]*)" and select item number "([^\"]*)"$/ do |text_to_press, index|

Long presses the text (if found) and select the specified number in the context menu that appear.

Then /^I long press "([^\"]*)" and select "([^\"]*)"$/ do |text_to_press, context_text|

Long presses the text (if found) and select the specified number in the context menu that appear.

Given /^I set the date to "(\d\d-\d\d-\d\d\d\d)" on DatePicker with index "([^\"]*)"$/ do |date, index|

Finds the datepicker with the specified index and changes the date.

Given /^I set the time to "(\d\d:\d\d)" on TimePicker with index "([^\"]*)"$/
Given /^I set the "([^\"]*)" time to "(\d\d:\d\d)"$/

Finds the timepicker with the specified index and changes the time.

Given /^I set the "([^\"]*)" date to "(\d\d-\d\d-\d\d\d\d)"$/ do |content_description, date|

Find the datepicker by content description and changes the date.

Then /^I enter "([^\"]*)" into input field number (\d+)$/ do |text, number|

Enters the specified text into the input field with index number.

Then /^I enter "([^\"]*)" as "([^\"]*)"$/ do |text, target|
Then /^I enter "([^\"]*)" into "([^\"]*)"$/ do |text, target|

Enters the specified text into the input field that has a content desciption that matches the provided target.

Then /^I clear input field number (\d+)$/ do |number|

Finds a input field by index and blanks its value.

Then /^I clear "([^\"]*)"$/ do |name|

Finds a input field with matching content description and blanks its value.

Buttons

Simulates that the user pressed the back button.

Then /^I go back$/

Simulates that the user pressed the menu button.

Then /^I press the menu key$/

Gestures

To swipe left

Then /^I swipe left$/

To swipe right

Then /^I swipe right$/

To scroll down

Then /^I scroll down$/

To scroll up

Then /^I scroll up$/

Then /^I select "([^\"]*)" from the menu$/

Touching

Given /^I press the "([^\"]*)" button$/

Search for a button with the provided text and press it if found.

Then /^I press button number (\d+)$/

Presses the button by index.

Then /^I press image button number (\d+)$/

Presses the image button by index.

Then /^I press view with id "([^\"]*)"$/

Looks for a view with the provided id. If it is found and visible tries to click it.

Then /^I press "([^\"]*)"$/ do |identifier|

Will look for a view in the following order:

  1. Looks for a visible button with matching text.
  2. Look for a visible view with a matching content description.
  3. Look for a visible view with class name that matches the provided indentifier.

If a view is found we will try to click it.

Then /^I touch the "([^\"]*)" text$/

Will look for the specified text and press it if found.

Then /^I press list item number (\d+)$/

Will press the specified list item in the first visible list. Then /^I long press list item number (\d+)$/

Will lon press the specified list item in the first visible list.

Then /^I click on screen (\d+)% from the left and (\d+)% from the top$/

Simulates a touch on the screen at the specified location.

Waiting

Then /^I wait for progress$/ do

Will wait till there is no more progress bars.

Then /^I wait for dialog to close$/

Waits for the current dialog to close.

Then /^I wait for "([^\"]*)" to appear$/
Then /^I wait to see "([^\"]*)"$/

Waits for the specified text to appear.

Then /^I wait for the "([^\"]*)" button to appear$/

Waits for a button with the specified text to appear.

Then /^I wait for 1 second$/
Then /^I wait for a second$/

Waits for one second.

Then /^I wait$/

Waits for two seonds.

Then /^I wait for (\d+) seconds$/

Waits for a specified number of seconds.

Screenshots

To take a screenshot of the phone while running the test use any of these steps.

Then /^take picture$/
Then /^I take a picture$/
Then /^I take a screenshot$/

Location steps

If you app has the ALLOW_MOCK_LOCATION permission you can change the perceived location of the device by using any of these steps.

You can change the location any address or named location. This is done using the geocoder gem.

Then /^I am in "([^\"]*)"$/ do |location|
Then /^I am at "([^\"]*)"$/ do |location|
Then /^I go to "([^\"]*)"$/ do |location|

To use a set of concrete GPS cordinates

Then /^I am at ([-+]?[0-9]*\.?[0-9]+), ([-+]?[0-9]*\.?[0-9]+)$/ do |latitude, longitude|
Then /^I go to ([-+]?[0-9]*\.?[0-9]+), ([-+]?[0-9]*\.?[0-9]+)$/ do |latitude, longitude|

Rotation

These steps do nothing if you run them locally. If you run the test on LessPainful they will actually rotate the physical device.

Then /^I rotate the device to landscape$/
Then /^I rotate the device to portrait$/