testRigor English-language support documentation

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"

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 charded and expensive so you can mock the responses insted of call the real service.
• You can test your application individually if servers are instable or down.
• You can test specific scenarios, for example if you want to test a scenario where de server returns error.

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

upload file from saved value "sampleFile"
upload file "https://some-page.com/path-to-file" to mobile device

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"

call "+15344297154" and validate it was picked up //example
make call to "+15344297154" and check it was answered //example
call to +15344297154 //example
call "+15344297154" and check it was completed //example
call "+15344297154" from "+15551234567" and verify it is ringing //example
check that phone call from "+15344297154" is ringing //example
check that phone call from "+15344297154" was answered //example

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

sms "+15344297154" with body "this is content" and validate it was sent //example
send sms to "+15344297154" with content "this is content"
send message to "+15344297154" with text "this is content" and check it was delivered //example
send message from +15551234567 to "+15344297154" with text "this is content" and check it was failed
message from +15551234567 to "+15344297154" with body "this is content" and check it was not delivered

check that sms from "+12345678901" to "+12345678902" contains "Code" and matches regex "Code\:\d\d\d\d" and save it as "sms"

check that sms to "+12345678902" 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"

send sms from stored value "allocatedNumber" to stored value "answerPhoneNumber" with content from string with parameters starting from next line and ending with <END>
${answerCode} b
<END>

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"

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 //example
check that two emails to "[email protected]" and "Confirm" in subject were delivered //example
check that one or more emails to "[email protected]" and "Confirm" in subject were delivered //example
check that email to saved value "newEmail" was received //example
check that email to saved value "newEmail" from "[email protected]com" and "Confirm" in subject was received //example
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}"

set cookie "cookie value" as "cookie-name" //example
set cookie from saved value "variableName" as "cookie-name" //example
get cookie "cookie-name" and save it as "variableName" //example
clear cookies //example

set item "item-data" in sessionstorage as "item-name" //example
get item "item-name" from session storage and save it as "varName" //example
clear sessionstorage //example
set item "item-data" in localstorage as "item-name" //example
get item "item-name" from local storage and save it as "varName" //example
clear localstorage //example

set user agent to "My User Agent" //example
unset user agent //example

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

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"

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');"

Multiple Connections

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

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"