testRigor English-language support documentation

allocate a temporary number and save it as "newNumber"

click "Sign in"
enter "jacob" into "Username"
enter "jacobs-secure-password" into "Password"
click "Verify me"
check that sms to "+12345678902" is delivered and matches regex "Code\:\d\d\d\d" and save it as "sms"
extract value by regex "(?<=Code\:)[0-9]{4}" from "sms" and save it as "confirmationCode"
enter saved value "confirmationCode" into "code"
click "Continue to Login"
check that page contains text "Welcome, Jacob!"

login

enter stored value "username" into "email"
enter stored value "password" into "password"
click "Log In"

Email testing

send email to "[email protected]" with subject "Test message" and  body "Hi, this is a test, this is just a test message."
check that email from "[email protected]" is delivered

send email from "[email protected]" to "[email protected]" with  subject "Test message", and  body "Hi, this is a test, this is just a test message.", and attachment from saved value "Sample File"

send email from "[email protected]" to "[email protected]" with  subject "Test message", and  body "Hi, this is a test, this is just a test message.", and attachment "http://online.com/file/name.pdf"

1. "to" and "from" can be used at the same time. If not specified, "from" address will default to "[email protected]".
2. A stored file defined in "Test Data" can be used as an optional attachment. An attachment can also be a link to a file available online without username/password.
3. Both "from" and "to" addresses can be filled from stored values (e.g., "to saved value "newEmail" and/or "from saved value "newEmail")

check that email to "<random-user>@testrigor-mail.com" from "[email protected]" is delivered

check that two emails to "[email protected]" and "Confirm" in subject were delivered

check that one or more emails to "[email protected]" and "Confirm" in subject were delivered

check that email to saved value "newEmail" was received

check that email to saved value "newEmail" from "[email protected]" and "Confirm" in subject was received

check that email to saved value "newEmail" and "<regular expression>" in subject was received

check that email to "<random-user>@testrigor-mail.com" and "Confirm" in subject was received and show in mobile

check that email to "<random-user>@testrigor-mail.com" from "[email protected]" was not delivered

1. If the email count is not specified, we assume that only one message is expected. Multiple emails are treated as an error; so in order to avoid receiving the error message, specify the number of emails that should be expected or simply inform the system that more than one can be sent ad done below:

   check that one or more emails to saved value "<random-user>@testrigor-mail.com" were received

   example
2. The user should send a message to the following address:
   <random-user>@testrigor-mail.com, where <random-user> cab be any valid email handle. In order to avoid a conflict it is recommended that the user handle will contain customer name and some random part, e.g. [email protected]. This is important when you are running email tests in multiple browsers and/or on multiple machines at the same time. In this case it is your responsibility to ensure that you are not getting messages, meant for another test case run.
3. The user is expected to add some wait time before checking email. This check action will validate delivery, but not wait for the message to arrive. For example:

   wait 2 minutes

4. Once the action has been executed successfully, the message is deleted from the mailbox and rendered in a new tab. Multiple emails will be marked as error, but each one will be rendered in a separate tab. You can switch between tabs using switch to tab "1", switch to tab "2", etc. Note that old content will stay in the tab before the first rendered email message. In most cases it is tab "1", unless you opened more tabs.
5. Each email tab is rendered as an html page, so you can use any actions that you would use on an html page. There are a few useful element ids that will help getting specific parts of an email:
   • "message-froms" a list of "From" addresses (usually one address)
   • "message-subject" subject line
   • "message-date" message sent date and time in Pacific Time zone.
   • "message-tos" a list of "To" addresses
   • "message-ccs" a list of "CC" addresses
   • "message-bccs" a list of "BCC" addresses
   • "message-reply-to" "Reply To" address
   • "message-text" the message text
   • "message-attachments" a list of attachments (file names only)
6. If you want to check again, you need to re-send the mail. Your custom actions cannot contain multiple "check" actions for the same message.
7. Multiple recipients can be separated with "and":

   send email to saved value "newEmail" and saved value "newEmail2" with subject "Test" and body "Hi"

   example
8. When checking emails we only take into account those sent after a specific test case has started. This is to avoid a conflict when an email was left unchecked from a previous, unfinished run.

click "Sign up"
generate unique email, then enter into "Email" and save as "generatedEmail"
generate unique name, then enter into "Name" and save as "generatedName"
enter "PasswordSuperSecure" into "Password"
click "Submit"
check that email to stored value "generatedEmail" was delivered
click "Confirm email"
check that page contains "Email was confirmed"
check that page contains expression "Hello, ${generatedName}"

Browser cookies, localStorage, sessionStorage, userAgent

set cookie "cookie value" as "cookie-name"

set cookie from saved value "variableName" as "cookie-name"

get cookie "cookie-name" and save it as "variableName"

clear cookies

set item "item-data" in sessionstorage as "item-name"

get item "item-name" from session storage and save it as "varName"

clear sessionstorage

set item "item-data" in localstorage as "item-name"

get item "item-name" from local storage and save it as "varName"

clear localstorage

set user agent to "My User Agent"

unset user agent

Comments support

click "my-cryptic-button" // actually clicks "add to cart"

Audio testing

Recording

record audio through 10 seconds after clicking "audio-trigger" and save as "my-recording"

record audio from "my-audio-tag" through 20 seconds after clicking "audio-trigger" and save as "my-specific-recording"

Comparing

check that audio from "my-recording" is "70%" similar to "my-specific-recording"

check that audio from "my-recording" is "85%" similar to "https://some-page.com/path-to-file"

check that audio from "my-recording" is "99%" similar to "my-specific-recording"

check that audio from "my-recording" is "1%" different to "my-specific-recording"

Playing

play audio "https://some-page.com/path-to-file"

play audio "test-data-ref"

play audio "sound-to-play-ref" after clicking "start-recording" then click "stop-recording"

Validating

check that audio is playing

check that audio is not playing

Database Query Support

Managing Multiple Connections

run sql query "select top 1 UserID, LastName, FirstName from Users;" using connection "connectionName"
run no-sql query "" using connection "anotherConnectionName"

Overriding the settings

save value "user" as "connectionName:usernameJDBC". 
save value "pass12345" as "connectionName:passwordJDBC
save value "jdbc:mysql:host:port" as "connectionName:connStringJDBC"
run sql query "select top 1 UserID, LastName, FirstName from Users;" using connection "connectionName"

SQL Database Support

Select

run sql query "select top 1 UserID, LastName, FirstName from Users;"

enter stored value "FirstName" into "First name"
check that stored value "LastName" itself contains "Doe"

Insert

run sql query "insert into Users(UserID, FirstName, LastName) values (3, 'Jon', 'Doe');"

No-SQL Database Support

Find

run no-sql query "{\"find\": \"Users\", \"limit\": 1, \"projection\": {\"userId\": 1, \"firstName\": 1, \"lastName\": 1}}"

enter stored value "FirstName" into "First name"
check that stored value "LastName" itself contains "Doe"

Insert

run no-sql query "{\"collection\": \"Users\", \"documents\": [{\"userId\": 3, \"firstName\": \"Jon\", \"lastName\": \"Doe\"}]}"

Chrome Extensions Testing

open extension "myextension"

activate extension "myextension"

Captcha resolution (not included by default)

Image to text type of captcha

resolve captcha of type image from "captcha element"

enter stored value "captchaText" into "Enter captcha text here..."
click "Validate"

Google Re-Captcha type of captcha

resolve captcha of type recaptcha

enter stored value "captchaToken" into "g-recaptcha-response"
click "Validate"

Scan QR Code

Scan QR Code from stored image

scan qr code value from stored value "saved-qr-code" and save as "code"

Scan QR Code from screen

scan qr code value from "code-container" on the right of "QR Code 2" and save as "code"

Validation of API calls made by the browser (Chrome/Edge only)

• Request URL: We will find requests to a target URL starting with your input
• Request method: GET, POST, PUT, PATCH, DELETE, etc
• Request headers: filtering among the requests those with headers containing your input
• Request body: filtering requests sending data containing your input
• Response status code: finding a response received with that status code
• Response headers: finding a response received with headers containing the input

• Filter by request URL matching
• Filter by request method matching
• Filter by request headers matching
• Filter by request body matching
• Filter by response status code
• Filter by response headers

check that api call was made to POST from stored value "myURL" with headers containing "some-header-value" and "\"Content-Type\":\"application/json\"" and text starting from next line and ending with [END]
"Referer":"https://testrigor.com"[END] and the request body containing "some data" and the response code was "200" and response headers containing "resp-header-value"

check that the browser called api "https://testrigor.com" and response code was "200"

check that api call was made to url "https://testrigor.com" with headers containing from stored value "myHeader"

check that api call was made with response headers "some-value" and from stored value "myHeaderVariable"

Request body types to filter

Text body parameter

check that api call was made to POST "https://testrigor.com" with body containing "some_data1" and  text "some_data2"

JSON body parameter

check that api call was made to POST "https://testrigor.com" with body containing json "key1 : value1" and json "\"key2\":\"value2\""

JSON PATH body parameter

check that api call was made to POST "https://testrigor.com" with body containing json path "$.some_path[?(@.value < 10)]"

testRigor advanced topics

store value "hello" as "var1"
execute JavaScript text starting from next line and ending with [END]
  if (testRigor.hasStoredValue("var1")) {
    testRigor.execute('enter stored value "var1" into "Message"');
  }
  testRigor.execute('click "Update"');
  testRigor.execute('check that page contains text from stored value "var1"');
[END]

interface TestRigor {
  /**
   * True if variable had been assigned a value.
   */
  boolean hasStoredValue(String storedValueName);
  /**
   * Gets the value of the variable.
   */
  String getStoredValue(String storedValueName);
  /**
   * Sets the value of variable.
   */
  String putStoredValue(String storedValueName, String value);
  /**
   * Extracts the full variable-to-value map.
   */
  Map<String, String> getReadOnlyStoredValuesMap();
  /**
   * Gets tree of elements for the current screen.
   */
  UiElement getNodeTree();
  /**
   * Execute the commands. Can be multiple commands new-line separated.
   */
  boolean execute(String commands);
}

interface UiElement {
  String getElementName();
  String getHtmlNodeName();
  double getY();
  double getX();
  double getHeight();
  double getWidth();
  UiElement getParent();
  String getText();
  String getPath();
  String getShortPath();
  String getFullPath();
  String getName();
  String getLabel();
  String getHint();
  String getTitle();
  String getClassName();
  String getResourceId();
  String getOcrText();
  String getPlaceholder();
  String getAlternative();
  String getType();
  String getValue();
  String getAriaLabel();
  String getRole();
  boolean isVisible();
  boolean isEnabled();
  boolean isClickable();
  boolean isChecked();
  boolean hasProperty(String propertyName);
  String getProperty(String propertyName);
}

1. x
2. y
3. height
4. width
5. visible
6. ocrText - only available if OCR is enabled
7. shortPath - short version of XPath leveraging ids where possible
8. fullPath - direct full XPath from the root
9. path - one of the above based on the settings

command [index] [typeOfElement] ["containing"] ["saved value" | "parameterized string"] [elementReference] ["in the context of", elementReference]

elementReference = \"elementName\", {"or", elementReference} [insideTableReference]

insideTableReference = "at" ["row", elementReference] ["column", elementReference]

click on the first button "delete" or "remove" in the context of the first table "visible" at the row containing saved value "generatedId" and column "actions"

click XPath "/html/body/div[3]"

click CSS Selector "a[target=_blank]"

Automate testing tables

Selecting a row in a table

click "Delete" inside of table at row containing "my unique id" and column "Actions"

check that table with "Country" equal to "United States" and "City" equal to "Saint Petersburg" and "State" equal to "Florida" at column "Status" contains "Flourishing"

• AND
• OR
• NOT
• Brackets ()

check that table with not("Country" not equal to "United States" or "City" not equal to "Saint Petersburg" or "State" not equal to "Florida") at column "Status" contains "Flourishing"

click on the first button in the context of table with "Name" equal to "Spock" and "Ship" equals to "Kelvin" at column "Actions"

Calculating aggregates

Order of values

check that table "actions" at column "Name" has values sorted in ascending order check that table "actions" at column "Name" has values sorted in descending order

Number of values (count)

check that table "actions" at column "Name" the value count is greather than "3"
check that table "actions" at third column the value count is less than "20"
check that table "actions" at column "Name" the value count is equals to "5"
check that table "actions" at third column the value count is equals to stored value "expectedValueCount"

Sum of values

check that table "actions" at column "#" the sum of values is greater than "10"
check that table "actions" at first column the sum of values is less than "50"
check that table "actions" at column "#" the sum of values is equals to "15"
check that table "actions" at first column the sum of values is less than stored value "expectedValueSummatory"

Average of values

check that table "actions" at column "#" the average of values is greater than "1"
check that table "actions" at first column the average of values is less than "6"
check that table "actions" at column "#" the average of values is equals to "3"
check that table "actions" at first column the average of values is equals to stored value "expectedValueAvg"

JsonPath Overview

$.store.book[0].title

$['store']['book'][0]['title']

Functions

Filter Operators

Path Examples

{
  "store": {
      "book": [
          {
              "category": "reference",
              "author": "Nigel Rees",
              "title": "Sayings of the Century",
              "price": 8.95
          },
          {
              "category": "fiction",
              "author": "Evelyn Waugh",
              "title": "Sword of Honour",
              "price": 12.99
          },
          {
              "category": "fiction",
              "author": "Herman Melville",
              "title": "Moby Dick",
              "isbn": "0-553-21311-3",
              "price": 8.99
          },
          {
              "category": "fiction",
              "author": "J. R. R. Tolkien",
              "title": "The Lord of the Rings",
              "isbn": "0-395-19395-8",
              "price": 22.99
          }
      ],
      "bicycle": {
          "color": "red",
          "price": 19.95
      }
  },
  "expensive": 10
}

Regex Random String Generation Support

generate by regex "<(a|button)>data<\/>", then enter into "Tag data" and save as "generatedTag"

generate by regex "https://(www\.)?([a-z][a-z0-9-]{2,30}[a-z0-9]\.){1,5}(com|edu|co\.uk|info|io)", then enter into "URL" and save as "generatedUrl"

Regex Random Data Generation Cookbook

generate by regex "<YOUR_REGEX>", then enter into "Email" and save as "newEmail"

Regex Random Generation Syntax Support

generate by regex "[A-Z][a-z]{2,50}", then enter into "Name" and save as "generatedName"

Advanced Topics

Regex for validations and search

check that page has regex "Current time: [0-2][0-9]:[0-5][0-9]"
check that page doesn't have regex "fail|crash|500"
check that URL matches regex "https://mycompany\.com/list/item/[a-z0-9]{2,30}"
check that text below "Current time" matches regex "[0-2][0-9]:[0-5][0-9]"
grab value of regex "[0-2][0-9]:[0-5][0-9]" and save it as "currentTime"

How to use simple templates to generate unique data

generate from template "###-555-####", then enter into "Phone" and save as "generatedPhone"

Unique data generating symbols

Examples

generate unique email, then enter into "Email" and save as "newEmail" generate unique name, then enter into "Name" and save as "generatedName"

What is Boolean Logic

• AND
• OR
• NOT
• Brackets ()

AND operator

OR operator

NOT operator

Brackets ()