testRigor English-language support documentation

generate from regex "[a-z]{10,18}", then enter into "Notes" and save as "actionNotes"

enter stored value "username" into "username_field"

enter stored value "password" into "password_field"

enter from the string with parameters "${homePrefix}/my/path" into "urlPath"

Calculations and equations

check that expression "${a} + ${b}" itself is equal as a number to "42"

save expression "${a} + ${b}" as "answer"

check that page contains expression "var aDate=new Date();aDate.setDate(aDate.getDate()-30);''+aDate.getFullYear()"

Pre-defined Variables

1. username - enter stored value "username" into "Email" example
2. password - enter stored value "password" into "Password" example
3. homeDomain - (from URL in Test Suite Details: www.example.com) open URL from string with parameters "https://${homeDomain}/cart/checkout/confirm" example
4. homeFile - (from URL in Test Suite Details: /cart/checkout/confirm) open URL from string with parameters "https://www.example.com${homeFile}" example
5. homePrefix - (from URL in Test Suite Details: https://www.example.com) open URL from string with parameters "${homePrefix}/cart/checkout/confirm" example
6. todayYear - (2023) enter stored value "todayYear" into "YYYY" example
7. todayYearShort - (23) enter stored value "todayYearShort" into "Year" example
8. todayMonthNumber - (9) enter stored value "todayMonthNumber" into "Month" example
9. todayMonthNumberTwoDigits - (09) enter stored value "todayMonthNumberTwoDigits" into "Month" example
10. todayMonth - (September) click stored value "todayMonth" example
11. todayMonthShort - (Sep) click stored value "todayMonthShort" example
12. todayDayOfMonth - (2) enter stored value "todayDayOfMonth" into "Month" example
13. todayDayOfMonthTwoDigits - (02) enter stored value "todayDayOfMonthTwoDigits" into "Month" example
14. todayDayOfWeek - (Monday) enter stored value "todayDayOfWeek" into "Day" example
15. todayDayOfWeekShort - (Mon) enter stored value "todayDayOfWeekShort" into "Day" example
16. nowHour - (2 or 14) select stored value "nowHour" from "Start time" example
17. nowHourTwoDigits - (02 or 14) select stored value "nowHourTwoDigits" from "Start time" example
18. nowHourAmPm - (2) select stored value "nowHourAmPm" from "Itinerary" example
19. nowHourTwoDigitsAmPm - (02) select stored value "nowHourTwoDigitsAmPm" from "Itinerary" example
20. nowAmPm - (PM) select stored value "nowAmPm" from "Time of day" example
21. nowMinute - (5) enter stored value "nowMinute" into "Start time" example
22. nowMinuteTwoDigits - (05) enter stored value "nowMinuteTwoDigits" into "Start time" example
23. nowSecond - (7) enter stored value "nowSecond" into "Sec" example
24. nowSecondTwoDigits - (07) enter stored value "nowSecondTwoDigits" into "Sec" example
25. nowNanosecond - (355881000) save string with parameters "email${nowNanosecond}@testrigor-mail.com" as "newEmail" example
26. nowDateIso - (2023-09-02) save stored value "nowDateIso" as "currentDate" example
27. nowTimeIso - (02:05:07) save stored value "nowTimeIso" into "currentTime" example
28. nowDateTimeIso - (2023-09-02T02:05:07.165068-07:00[America/Los_Angeles]) save stored value "nowDateTimeIso" as "currentDateTime" example
29. nowMillisecondsFrom1970 - (1637061365335) save stored value "nowMillisecondsFrom1970" as "timeStamp" example
30. nowDateTimeRFC1123UTC - (Mon, 16 Sep 2023 16:32:41 GMT) save stored value "nowDateTimeRFC1123UTC" as "currentDateTime" example
31. nowUnixTime - (1637061404) save stored value "nowUnixTime" as "currentUnixTime" example
32. testSuiteParentFolder - enter stored value "testSuiteParentFolder" into "Field Name" example
33. testSuitePath - enter stored value "testSuitePath" into "Field Name" example
34. testSuiteName - enter stored value "testSuiteName" into "Field Name" example
35. testCaseName - enter stored value "testCaseName" into "Field Name" example
36. testCaseExecutionLink - enter stored value "testCaseExecutionLink" into "Field Name" example
37. currentUrl - save stored value "currentUrl" as "url" example
38. browser - save stored value "browser" as "variable name"
39. device - save stored value "device" as "variable name"
40. provider - save stored value "provider" as "variable name"
41. os - save stored value "os" as "variable name"
42. osVersion - save stored value "osVersion" as "variable name"
43. abi - save stored value "abi" as "variable name"
44. appFileName - (only for iOS, android, sandbox) save stored value "appFileName" as "variable name"

grab value from "some-element" and save it as "my-email"
grab value from input "some-edit" and save it as "my-email"

grab values from table "some-table" at column "some-column" and save it as "some-column-values"
grab values from table "some-table" at first row and save it as "first-row-values"

generate from regex "[a-z]{10,18}" and save as "actionNotes"

save value "Peter" as "name"

Executing actions in a loop

click "Next" until page contains stored value "previously generated id"

click "Next" up to 12 times until page contains strictly button "Place order"

Go To The Next Page until page contains stored value "previously generated id"
Do Something up to 12 times until page contains strictly button "Place order"

wait up to 20 seconds until page contains "non existent button"

Validations

1. Finding something on the screen/page
2. Validating properties or content of an element/finding element with given properties and content
3. Visual validations (colors, matching images to of elements to later versions)
4. Downloaded files validations
5. Audio validations (Ubuntu only)
6. Video validations (desktop web browser testing only)
7. Email validations
8. SMS validations
9. Phone call validations
10. Mathematical validations/calculations of formulas (even for data that just looks like financial data like -$30,000.23)
11. Built-in API validations
12. Chrome Extensions Testing
13. AI-based validations where you can use AI to assess if certain statements are true
14. Exploratory validations where you can ask AI to look at the screen and find obvious issues
15. And many more

1. contains/doesn't contain (text). For example, check that page contains "Error"
2. contains template/doesn't contain template (text). For example, check that page contains template "###-###-####"
3. contains regex/doesn't contain regex (text). For example, check that page contains regex "(+\d )?\d{3}-\d{3}-\d{4}"
4. return code is. For example, check that page return code is "404"
5. did not change compared to the previous step. For example, check that page did not change compared to the previous step
6. url starts with/url doesn't start with. For example, check that url starts with "https"
7. url contains/url doesn't contain. For example, check that url contains "testrigor.com"
8. url is/url is not. For example, check that url is "https://testrigor.com/docs/language/"
9. url ends with/url doesn't ends with. For example, check that url is "https://testrigor.com/docs/language/"
10. url matches regex/url doesn't match regex. For example, check that url matches regex "https://testrigor\.com/docs/\w+/"
11. title is. For example, check that page title is "testRigor - Documentation"
12. title contains. For example, check that page title contains "testRigor"

1. contains/doesn't contain (text) - example/example
2. is blank/is not blank - example/example
3. matches regex/doesn't match regex - example/example
4. matches simple template/doesn't match simple template - check that "section1" matches simple template "$########"
5. contains simple template/doesn't contain simple template - check that "section1" contains simple template "$########"
6. contains regex/doesn't contain regex - check that "section1" contains regex "[A-Z][a-z]+"
7. lexicographically before - check that "section1" lexicographically before "zzzz" (empty string is not lexicographically before anything)
8. lexicographically before or the same as - check that "section1" lexicographically before or the same as "zzzz" (empty string is not lexicographically before or the same as anything)
9. lexicographically after - check that "section1" lexicographically after "AAAA" (empty string is not lexicographically after anything)
10. lexicographically after or the same as - check that "section1" lexicographically after or the same as "AAAA" (empty string is not lexicographically after or the same as anything)
11. has value/doesn't have value (for inputs/text areas) - example/example
12. is checked/is not checked - example/example
13. is disabled/is enabled - example/example
14. is visible/is invisible - example/example
15. color is - example
16. is clickable/is not clickable - example/example
17. cursor is - example
18. has CSS class - example
19. background color is - example
20. has property - example
21. has options selected (for dropdowns when tagged as <select>) - example

check that "element" color is "ffaabb"
check that input "input" has value "value"
check that checkbox "Keep me signed in" is checked and stop test if fails
check that checkbox "Keep me signed in" is not checked

check that input "input" has value ""

check that property "background-color" of "my-div" is equal to "black"
check that property "width" of "my-div" is equal as a number to "310px"
check that property "height" of "my-div" is greater or equal than "170"

1. matches regex/doesn't match regex - example/example
2. contains/doesn't contain - example/example
3. is equal to/is not equal to - example/example
4. is null/is not null - example/example
5. is blank/is not blank - example/example

call api "https://testrigor.com" and save it as "variableName"
check that stored value "variableName" itself contains "James"

1. is equal as a number to/is not equal as a number to - example/example
2. is greater than - example
3. is greater or equal than - example
4. is less than - example
5. is less or equal than - example

1. page contains/page doesn't contain - example/example
2. page has regex/page doesn't have regex - example/example
3. page's return code is
4. title is - example
5. title contains - example
6. url is/url is not - example/example
7. url contains/url doesn't contain - example/example
8. url starts with/url doesn't start with - example/example
9. url ends with/url doesn't end with - example/example
10. url matches regex/url doesn't match regex - example/example

check that url matches regex from the string with parameters "${homePrefix}/product/${type}/[0-9A-Za-z\-]+"

AI-based testing

• Asking AI specific questions like check that page "contains a positive message in the chat response" using ai - example
• Getting UI issues from the screen check page for UI errors - example

Specific AI validations on the screen

check that page "contains a positive message in the chat response" using ai

check that statement is true "page contains TestRigor logo"

AI discovers issues itself

check page for UI errors
check page for UI errors reporting major errors or higher
check page for UI errors treating errors as major or lower
check page for UI errors reporting major errors or higher treating errors as major or lower
check page for UI errors treating errors as major or lower reporting major errors or higher

Visual Testing

compare screen
compare screenshot to previous version
compare screen to previous version with allowance of "1%" treating error as "minor"
compare screen to previous version treating error as "minor"

compare screen to stored value "Saved Screenshot"

Clicking on specific images with visual testing

click on the 6th element by image from stored value "logo" with less than "10" % discrepancy

click by image from stored value "logo" with less than "10" % discrepancy

Working with Tables

click on table "actions" at row "103" and column "Action"

click on table "actions" at row containing "spk2" and column "Actions"

click on "Ignore" within the context of table "actions" at row containing "spk2" and column "Actions"

enter "york1" into first table at the second header row and column "Id"

check that table "actions" at row "102" and column "Name" contains "Spock"

check that table "actions" at row "101" and column "Additional Data" has value "Looks like a trap"

enter "This is a trap!" into table "actions" at row "101" and column "Additional Data"

click "Open channel" within the context of second table at row "103" and column "Action"

check that the second table at row containing "Nyota" and column "Action" contains link "Open channel"
click the first button within the context of second table at row containing "Nyota" and column "Action"

Row or column value aggregation

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 greater than "2"
check that table "actions" at column "Name" the value count is less than "2"
check that table "actions" at column "Name" the value count is equals to "2"

Sum of values

check that table "actions" at column "#" the sum of values is greater than "100"
check that table "actions" at column "#" the sum of values is less than "500"
check that table "actions" at column "#" the sum of values is equals to "306"

Average of values

check that table "actions" at column "#" the average of values is greater than "100"
check that table "actions" at column "#" the average of values is less than "300"
check that table "actions" at column "#" the average of values is equals to "155"

Validating XLS, XLSX, and CSV File Downloads

click button "Download sample xlsx file"
check that file "file_example_XLSX_50.xlsx" was downloaded
check that file "file_example_XLSX_50.xlsx" at column "Id" the value count is greater than "2"

Conditional execution

Inline Conditional Command

click "element" if page contains "bla"

enter "macbook" into "search" if "Search in" has value "bla"

click "element" if exists

enter "bla" into "element" if exists

Inline Conditional Rule

My Rule if page contains "bla"
Purchase Product if "Search in" has value "Products"

Conditional blocks

if page contains "bla" then
  click "element"
  wait 10 sec
  enter "some text" into "some other element"
end

if page contains "bla" then
  click "element"
  wait 10 sec
else
  enter "some text" into "search"
  wait 10 sec
end

if page contains "bla" then
  click "element"
  wait 10 sec
else if page contains "search" then
  enter "some text" into "search"
  wait 10 sec
else if page contains "foo" then
  enter "foo bar" into "element"
  wait 10 sec
  click "some button"
else
  wait 10 sec
  logout
end

if page contains "bla" then
  check for some words
  open the main menu
  clear all
end

if page contains "Welcome" then
  accept all cookies
  wait 20 sec
  open the main menu
else if page contains "Search" then
  click "Search"
  enter "Big TV's"
  purchase the first item on the list
else
  login
end

Fail the test on purpose

fail

fail with "error"

API Testing

call api <TYPE> "<API_URL>" with headers "a:a" and "b:b" and body "body" and get "JsonPath" and save it as "variableName"

call api post "http://dummy.restapiexample.com/api/v1/create" with headers "Content-Type:application/json" and "Accept:application/json" and body "{\"name\":\"James\",\"salary\":\"123\",\"age\":\"32\"}" and get "$.data.name" and save it as "createdName"  and then check that http code is 200

call api "api" and save it as "variableName"

1. get - example
2. post - example
3. put - example
4. patch - example
5. head - example
6. delete - example
7. options - example
8. trace - example

call api post from the string with parameters "${homePrefix}/api/v1/create" with headers "Content-Type:application/json" and "Accept:application/json" and body text starting from next line and ending with [END]
{
  "param": "value",
  "param2": "value2"
}
[END] and get "$.data.name" and save it as "createdName"

call api post from the string with parameters "${homePrefix}/api/v1/create" with headers "Content-Type:application/json" and "Accept:application/json" and body from the string with parameters text starting from next line and ending with [END]
{
  "param": "value",
  "param2": "${dynamicValue}"
}
[END] and get "$.data.name" and save it as "createdName"

check that stored value "createdName" itself contains "James"

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"

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

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

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

Mocking API calls

mock api call <TYPE> "<API_URL>" returning body "<MOCK_BODY>"

mock api call get "https://dummy.restapiexample.com/api/v1/employees" with headers "a:a" returning body "This is a mock response" with http status code 200

• You might want to use mocking APIs if you are using third-party API calls. Those calls can be charged and expensive, so you can mock the responses instead of calling the real service.
• You can test your application individually if servers are unstable or down.
• You can test specific scenarios, for example, if you want to test a scenario where the server returns error.

Uploading files using browser

enter stored value "keyName" into input file "fileField"

enter "<FILE_URL>" into file input "fileField"

enter stored value "myFile" into input type file

enter stored value "myFile" into 3rd input type file
enter stored value "myFile" into input type file in the context of "Select file"

Multiple files

enter from the string with parameters text starting from next line and ending with [END]
${file_var_one}
<FILE_URL>
[END] into file input "myFileInput"

Working with folders

Template files

some value, ${variable1}, another value
${variable2}, fixed value, ${variable3}

enter template stored value "keyName" into input file "fileField"
enter template "<FILE_URL>" into file input "fileField"

Phone calls

call "+15344297154" and validate it was picked up

make call to "+15344297154" and check it was answered

call to +15344297154

call "+15344297154" and check it was completed

call "+15344297154" from "+15551234567" and verify it is ringing

check that phone call from "+15344297154" is ringing

check that phone call from "+15344297154" was answered

call from stored value "allocatedNumber" to stored value "answerPhoneNumber"

CSV Files

click "download" on the right of "Pokemons.csv"
check that file "Pokemons.csv" was downloaded
run sql query "select Type from Pokemons;" using file "Pokemons.csv"

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"

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<\/\1>", 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 ()