Marking tests as Passed, Failed or in Error using MarkFailed, MarkPassed, MarkError in Katalon Studio

We previously looked at the idea of writing information to the log files. This included the output of variable values and status messages. But, what if you need to stop the test and mark it as failed because the data you needed wasn’t there, or the information you did read indicates a more serious problem? Katalon Studio will mark a test as failed if the command fails to execute, but there is a way to fail the test because of other errors. Again, it takes a little digging to find the right command, but they certainly exist.

To start, an import statement is needed at the top of the project:

import com.kms.katalon.core.util.KeywordUtil

Once that’s in place, a test can be flagged in several ways using one of these commands:

KeywordUtil.markPassed
KeywordUtil.markFailed
KeywordUtil.markError
KeywordUtil.markWarning

* https://api-docs.katalon.com/studio/v4.6.0.2/api/com/kms/katalon/core/util/KeywordUtil.html

With these KeywordUtil commands, you have a great deal of flexibility in controlling the execution of your tests. For this small snippet, the two values I’m working with are written to the log file. I then use KeywordUtil to mark the test as passed or failed if those two values match or not.

log.logWarning('The All filter displays: ' + filterAllUsers)
log.logWarning('The number of users for Pagination displays: ' + footerAllUsers)
if(filterAllUsers==footerAllUsers){
 KeywordUtil.markPassed('SUCCESS: The Filter Results Matches the Pagination Results')
} else {
 KeywordUtil.markFailed('ERROR: The Filter Results Does NOT Match the Pagination Results')
}

The test itself will pass since there is no error in the code or in finding the elements on the page. However, if the values I’m comparing aren’t equal, I need to fail the test so I can look at it manually and determine the problem.

As another example, I need to check one of our sales dashboards. Due to some data inconsistencies during import, it’s possible for the month to display twice on the page, as in January, January, February, February.

Verifying these duplicate values won’t get the test to fail, the code executes correctly. But, now I can force it to error when I evaluate a duplicated month.

//Count the number of months in the table. If there are more than 12, there's an error with duplication
log.logWarning('Number of Months displayed in the Table: ' + TotalRowCount.size())
if (TotalRowCount.size() > 12){
 log.logWarning('There are more than 12 months. This is an error.')
 KeywordUtil.markError('ERROR: There are more than 12 months. This is an error.')
}

//If the above passes, such as an onboarded user, check that the text of the first month isn't the same as the second
//Compare the first two months, display the first three for visual comparison
monthName1 = driver.findElement(By.xpath("//*[@id='byMonth']/div/table/tbody/tr[1]/td[1]")).getText();
log.logWarning('Month:=' + monthName1)
monthName2 = driver.findElement(By.xpath("//*[@id='byMonth']/div/table/tbody/tr[2]/td[1]")).getText();
log.logWarning('Month:=' + monthName2)
monthName3 = driver.findElement(By.xpath("//*[@id='byMonth']/div/table/tbody/tr[3]/td[1]")).getText();
log.logWarning('Month:=' + monthName3)
if (monthName1==monthName2){
 log.logWarning('The two months sampled have the same text. The months appear to be duplicated.')
 KeywordUtil.markError('ERROR: The two months sampled have the same text. The months appear to be duplicated.') 
}

Again, I’m using both log.LogWarning and KeywordUtil.markError to output values and then mark the test as in error.

A test can be passed or failed for almost any reason you can control. As another example, here is a snippet of code that indicates whether a Contact was created successfully if the popup dialog indicates there was a success.

elementPresent=WebUI.waitForAlert(20)
if (elementPresent==true) {
 alertText = WebUI.getAlertText()
 log.logWarning('The title of the alert is:=' + alertText)
 if (alertText=='Successfully Created Contact'){
 KeywordUtil.markPassed('SUCCESS: Successfully Created the Prospect')
 WebUI.acceptAlert()
 } else {
 WebUI.acceptAlert()
 KeywordUtil.markFailed('ERROR: There was an error creating the Prospect')
 }
}

After the contact is created, the code waits for an alert to display. For that alert, read the text. If the text is “Successfully Created Contact” then obviously all is well. If it reads as something else, then a problem has occurred and the test will be marked as Failed so I can review it later.

It’s also possible to brute force end the execution of the test using the throw command. The following will stop the test in it’s tracks and log an error:

throw new AssertionError('ERROR: There was an error creating the Prospect')

As noted before, the count of Passed, Failed and Error tests is displayed on the Log Viewer.

Katalon offers a huge amount of flexibility with the inclusion of KeywordUtil.markFailed and KeywordUtil.markError. It’s now possible to indicate there is a problem even when all the commands execute successfully. Or, you can exit out gracefully if you know the information you just read would cause the rest of the test to fail. An ideal case would be reading the value $0, right before you perform a calculation.

Other articles of interest:

Leave a Reply

Your email address will not be published. Required fields are marked *

Recent Comments
  • How to Block games by Title and Tag on Steam (1)
    • JACK: Thanks, same just wanted to block anime games in my discover
  • How To Disable the Quicken Registration Prompt (25)
    • Greg: For me, holding the *LEFT* CTL + Shift then clicking Online, One Step Update worked. I originally tried holding the right CTL + Shift, and it didn’t work. I’m using Quicken 2006, so I don’t know if it will work...
    • Joe SR>: My monthly income is deposited into my Credit Union account. I use debit whenever possible. I write checks manually and mail them. I use Quicken 2012 off-line only. I have entered all my money and investment accounts. I...
    • Prtet: Never say never….every time I swear I will never use Quicken again, I discover that there are still no viable alternatives. Amazing that there is no decent personal finance software.
    • Joe D.: Holding CTRL + Shift keys and selecting On Line | One Step Update from the main menu worked for my Quicken 2004. I’m grateful that you wrote a synopsis (“Simply put, …”) just beneath the link to the blog...
    • Susan Long: I bought my quicken disc in the beginning and it came with a registration number. I rang the helpline and they gave me the code to put in and talked me through it. It you downloaded your version then you don’t own it...
    • Peter: You might consider running your old version of Quicken on an ancient computer. This is what I have done for years. The newer versions are fraught with problems- criminal, in my opinion. One version made mathmatical errors when...
    • Roslyn Chamberlain: Can I stop the countdown in quicken 2001 says only 8 sessions left. and what will happen after?
  • Parsing Strings in Katalon – Split, Substring and Readlines (1)
    • Ellen: Thanks for sharing!! I like your contributions to Katalon topics.
  • Working with Dates and Date Formatting in Katalon Studio (6)
    • Ajoo: Thank you for the details. How do i remove leading “0” from dates. i.e. while formatting i receive 04/21/2019, but i need 4/21/2019. (same applies for date)
  • What is Katalon Studio? A Distro of Selenium, Groovy and Eclipse (1)
    • Mahesh: Looking for more posts on katalon studio.your katalon stuffs are always exiting
  • Simple wildcard searches for pattern matching (2)
    • Don Pedro: For that scenario it seems .contains would be your choice. For example, variable.contains(‘amazo n.com’) to see if the url had amazon.com. In that case, www.amazon.com, forum.amazon.com, retail.amazon.com would all...
    • Jony: Hi, How can I use a wild card to assert a URL is the one I want. I just want to verify the domain ==expected but not anything after it. Tried * but not working and only works when I have full URL.
  • Create a Dynamic Object at Runtime (2)
    • Saish: How to add shadow root parent to this runtime object..
    • Jeremy Brien: I appreciate this! I saw this post on LinkedIn this morning and was able to find a use case for it! I found that defining my xpath with an iterable variable allows me to loop through and capture text from tables created...