Other Utilities in Katalium Framework

Parameterization

TestNG provides a comprehensive mechanism for customizing parameters, which can be referred here.

In Katalium Framework, you can set default values for parameters in the file kata-default.properties (example), or using at runtime using Java's system properties, e.g. mvn clean test -DkataBrowser=firefox. This is very handy when you do not want reconfigure unchanged parameters.

Default values of parameters can be accessed using the helper com.katalon.kata.helper.ParameterHelper.

Logging

Katalium Framework provides the class com.katalon.kata.helper.LogHelper to help retrieve org.slf4j.Logger instances with correct class names.

private static final Logger log = LogHelper.getLogger();

log.info("Open CURA home page.");

Sample output:

09:26:29.475 [main] INFO  com.katalon.kata.testng.TestTemplate - Make appointment with parameters
09:26:29.475 [main] INFO  com.katalon.kata.testng.TestTemplate - Facility Hongkong CURA Healthcare Center
09:26:29.476 [main] INFO  com.katalon.kata.testng.TestTemplate - VisitDate 27/12/2016
09:26:29.476 [main] INFO  com.katalon.kata.testng.TestTemplate - Comment Please make appointment as soon as possible.
09:26:29.476 [main] INFO  c.katalon.kata.selenium.PageTemplate - Open CURA home page.
09:26:38.528 [main] INFO  c.katalon.kata.selenium.PageTemplate - Make appointment.

Logs will be printed out on the console and in TestNG XML reports.

Capture WebDriver actions

You can attach a custom org.openqa.selenium.support.events.AbstractWebDriverEventListener to capture WebDriver events (source code):

package com.katalon.kata.sample.listener;

import com.katalon.kata.webdriver.WebDriverPool;
import org.testng.IExecutionListener;

public class EventListener implements IExecutionListener {
    @Override
    public void onExecutionStart() {
        WebDriverPool webDriverPool = WebDriverPool.get();
        webDriverPool.setAfterCreateDriverListener(
            driver -> { driver.register(new WebDriverEventListener()); });
    }

    @Override
    public void onExecutionFinish() {}
}