Sample WebUI tests project (Healthcare sample) in Katalon Studio

This sample demonstrates WebUI testing fundamentals in Katalon Studio. The Application Under Test (AUT) is the CURA Healthcare Service website: https://katalon-demo-cura.herokuapp.com/. You can learn more about WebUI testing in this document: Introduction to WebUI testing.

Open the Healthcare sample project

In Katalon Studio - Platform Edition

On Katalon TestOps, open a project and clone this sample test from our GitHub repository: Healthcare sample. See: Upload Test Scripts from a Git Repository.

In Katalon Studio - Platform Edition, open that project by going to File > Open Project.

In Katalon Studio - Standalone Edition

To open the Healthcare sample project, in Katalon Studio, go to File > New Sample Project > Sample Web UI Tests Project (Healthcare).

Alternatively, you can download the Healthcare sample project from our GitHub repository: Healthcare sample.

Healthcare sample project components

Profiles

To open the execution profile, go to Profiles > default.

You can create and save all global variables in the execution profile. They can be used across test cases in your project. To learn more about execution profiles and global variables, you can refer to this document: Execution profile and global variables.

Katalon creates three global variables in this sample project as follows:

Name	Value
G_Timeout	10
G_SiteURL	http://demoaut.katalon.com
G_ShortTimeOut	5

Custom keywords

You can use custom keywords in the test case. To learn more about custom keywords, you can refer to this document: Introduction to custom keywords.

Katalon creates three custom keywords in this sample project. To see the custom keywords, in the Test Explorer panel, go to Keywords > com.example > WebUICustomKeywords.groovy.

• com.example.WebUICustomKeywords.isElementPresent

  Description

  This keyword is to check if an element displays within a predefined time limit.

  Parameters

  Parameter	Type	Mandatory	Description
  to	TestObject	Required	A Katalon test object
  timeout	int	Required	The timeout to wait for the element to appear (in seconds).

  Returns

  Param Type	Type
  boolean	true: if the element presents. false: if the element does not present.

  Example

  In this example, we want to check whether the Make Appointment button displays within 10 seconds.

  import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
  import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
  import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
  import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
  import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
  import com.kms.katalon.core.checkpoint.CheckpointFactory as CheckpointFactory
  import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as MobileBuiltInKeywords
  import com.kms.katalon.core.model.FailureHandling as FailureHandling
  import com.kms.katalon.core.testcase.TestCase as TestCase
  import com.kms.katalon.core.testcase.TestCaseFactory as TestCaseFactory
  import com.kms.katalon.core.testdata.TestData as TestData
  import com.kms.katalon.core.testdata.TestDataFactory as TestDataFactory
  import com.kms.katalon.core.testobject.ObjectRepository as ObjectRepository
  import com.kms.katalon.core.testobject.TestObject as TestObject
  import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WSBuiltInKeywords
  import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUiBuiltInKeywords
  import internal.GlobalVariable as GlobalVariable
  import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
  import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
  import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
  
  /*Open browser and navigate to the AUT website.*/
  WebUI.openBrowser(GlobalVariable.G_SiteURL)
  
  /*Check to see whether the Make Appointment button presents within 10 seconds*/
  CustomKeywords.'com.example.WebUICustomKeywords.isElementPresent'(findTestObject('Page_CuraHomepage/btn_MakeAppointment'), 10)
  
  WebUI.closeBrowser()
  

• com.example.WebUICustomKeywords.getHtmlTableRows

  Description

  This keyword retrieves web elements from all rows in an HTML table. To learn more about the HTML element of a table, you can refer to this Mozilla developer document: HTML table basics.

  Parameters

  Parameter	Type	Mandatory	Description
  table	TestObject	Required	A Katalon test object represents an HTML table.
  outerTagName	string	Required	The outer tagname of the tr tag, usually tbody

  Returns

  The web elements of all rows in the HTML table.

  Example

  In this example, we want to retrieve the web elements of all rows in an HTML table body.

  After creating a test object representing the HTML table, apply the com.example.WebUICustomKeywords.getHtmlTableRows custom keyword as follows:

  import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
  import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
  import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
  import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
  import static com.kms.katalon.core.testobject.ObjectRepository.findWindowsObject
  import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
  import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
  import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
  import com.kms.katalon.core.model.FailureHandling as FailureHandling
  import com.kms.katalon.core.testcase.TestCase as TestCase
  import com.kms.katalon.core.testdata.TestData as TestData
  import com.kms.katalon.core.testng.keyword.TestNGBuiltinKeywords as TestNGKW
  import com.kms.katalon.core.testobject.TestObject as TestObject
  import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
  import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
  import com.kms.katalon.core.windows.keyword.WindowsBuiltinKeywords as Windows
  import internal.GlobalVariable as GlobalVariable
  import org.openqa.selenium.Keys as Keys
  
  /*Open the website contains the table*/
  WebUI.openBrowser('https://docs.katalon.com/katalon-studio/docs/webui-click.html')
  
  /*Get web elements of all rows of the table body*/
  CustomKeywords.'com.example.WebUICustomKeywords.getHtmlTableRows'(findTestObject('Object Repository/Table/New Test Object'), 'tbody')
  
  WebUI.closeBrowser()
  

• com.example.WebUICustomKeywords.getHtmlTableColumns

  Description

  This keyword retrieves web elements of all cells of a row in an HTML table. To learn more about the HTML element of a table, you can refer to this Mozilla developer document: HTML table basics.

  Parameters

  Parameter	Type	Mandatory	Description
  table	WebElement	Required	A WebElement represents a row of an HTML table
  tagName	string	Required	The HTML column tagname, usually td/th

  Returns

  The web elements of all cells of a row in the HTML table.

  Example

  In this example, we want to retrieve the web elements of all cells of the first row in the following HTML table body.

  
  
  

  As shown in the above picture, the row index starts at 0. Here, to get the first line of the table body, we set paramter as row[0] and use the com.example.WebUICustomKeywords.getHtmlTableRows custom keyword as follows:

  import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
  import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
  import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
  import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
  import static com.kms.katalon.core.testobject.ObjectRepository.findWindowsObject
  import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
  import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
  import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
  import com.kms.katalon.core.model.FailureHandling as FailureHandling
  import com.kms.katalon.core.testcase.TestCase as TestCase
  import com.kms.katalon.core.testdata.TestData as TestData
  import com.kms.katalon.core.testng.keyword.TestNGBuiltinKeywords as TestNGKW
  import com.kms.katalon.core.testobject.TestObject as TestObject
  import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
  import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
  import com.kms.katalon.core.windows.keyword.WindowsBuiltinKeywords as Windows
  import internal.GlobalVariable as GlobalVariable
  import org.openqa.selenium.Keys as Keys
  
  /*Open the website contains the table*/
  WebUI.openBrowser('https://docs.katalon.com/katalon-studio/docs/webui-click.html')
  
  /*Get web elements of all rows of the table body*/
  Rows = CustomKeywords.'com.example.WebUICustomKeywords.getHtmlTableRows'(findTestObject('Object Repository/Table/New Test Object'), 'tbody')
  
  /*Get web elements of all cells of the first row of the table body*/
  TableColumns = CustomKeywords.'com.example.WebUICustomKeywords.getHtmlTableColumns'(Rows[0], 'td')
  
  WebUI.closeBrowser()
  

Test cases

Test suite and test suite collection

There are two test suites in this project. To access them, in the Test Explorer panel, go to Test Suites.

1. The test suite Healthcare-tests - TS_RegressionTest combines the three test cases shown above.

   
   
   

2. The test suite collection Healthcare-tests - TS_RegressionTestCollection combines two Healthcare-tests - TS_RegressionTest test suites with different testing environments. In this project, we run the test suites with Firefox and Chrome.

   
   
   

Execute selected test case or test suite/test suite collection

To execute a test case or a test suite/test suite collection in the sample project:

1. Select the test case/test suite/test suite collection you want to execute.

2. Click Run or press Ctrl + Shift + A (macOS: Cmd+Shift+A).

   You can choose different browsers to execute your test in the dropdown list next to Run.

   
   
   

3. Observe the test result in the Log Viewer tab. To learn more about analyzing test execution logs, you can refer to this document: [WebUI] Analyze Test Execution Logs and Debug the Test Case.

   
   
   

   Note:

   • You can view test results in the Result tab at the test suite or test suite collection level. The test results can be Passed, Failed, Error, or Incomplete. To learn more about the test status, you can refer in this document: View and Customize Execution Log.
   • After executing test suites or test suite collections, you can view your reports and details in <your-project-folder>/Reports. Katalon Studio also supports exporting test reports into different formats, such as HTML, CSV, PDF, and JUnit.
   • For real-time monitoring and better reporting capabilities, consider integrating your project with Katalon TestOps. Learn more about test result reports here: Upload Test Results to Katalon TestOps from Katalon Studio.

See also

• Create test cases using Record & Playback