Sample Custom Keywords in Katalon Studio

Important:

• You have a Katalon Studio Enterprise license.

When creating a New Custom Keyword, you have the options to generate sample custom keywords used for either Web, Mobile or API testing. They provide a great example to learn how to create custom keywords with proper coding convention in Katalon Studio from scratch.

The options are displayed directly when you create a new custom keyword.

Option	Description
Generate sample keywords for Web	Generate some sample functions used for Web Testing
Generate sample keywords for Mobile	Generate some sample functions used for Mobile Testing
Generate sample keywords for API	Generate some sample functions used for API Testing

You can select one or all of these options to have all sample custom keywords generated in one file. For example, select all options, the generated custom keyword will look like as below:

class sampleKeywords {
    /**
     * Refresh browser
     */
    @Keyword
    def refreshBrowser() {
        KeywordUtil.logInfo("Refreshing")
        WebDriver webDriver = DriverFactory.getWebDriver()
        webDriver.navigate().refresh()
        KeywordUtil.markPassed("Refresh successfully")
    }

    /**
     * Click element
     * @param to Katalon test object
     */
    @Keyword
    def clickElement(TestObject to) {
        try {
            WebElement element = WebUiBuiltInKeywords.findWebElement(to);
            KeywordUtil.logInfo("Clicking element")
            element.click()
            KeywordUtil.markPassed("Element has been clicked")
        } catch (WebElementNotFoundException e) {
            KeywordUtil.markFailed("Element not found")
        } catch (Exception e) {
            KeywordUtil.markFailed("Fail to click on element")
        }
    }

    /**
     * Get all rows of HTML table
     * @param table Katalon test object represent for HTML table
     * @param outerTagName outer tag name of TR tag, usually is TBODY
     * @return All rows inside HTML table
     */
    @Keyword
    def List<WebElement> getHtmlTableRows(TestObject table, String outerTagName) {
        WebElement mailList = WebUiBuiltInKeywords.findWebElement(table)
        List<WebElement> selectedRows = mailList.findElements(By.xpath("./" + outerTagName + "/tr"))
        return selectedRows
    }

    /**
     * Check if element present in timeout
     * @param to Katalon test object
     * @param timeout time to wait for element to show up
     * @return true if element present, otherwise false
     */
    @Keyword
    def isElementPresent_Mobile(TestObject to, int timeout){
        try {
            KeywordUtil.logInfo("Finding element with id:" + to.getObjectId())

            WebElement element = MobileElementCommonHelper.findElement(to, timeout)
            if (element != null) {
                KeywordUtil.markPassed("Object " + to.getObjectId() + " is present")
            }
            return true
        } catch (Exception e) {
            KeywordUtil.markFailed("Object " + to.getObjectId() + " is not present")
        }
        return false;
    }

    /**
     * Get mobile driver for current session
     * @return mobile driver for current session
     */
    @Keyword
    def WebDriver getCurrentSessionMobileDriver() {
        return MobileDriverFactory.getDriver();
    }

    /**
     * Send request and verify status code
     * @param request request object, must be an instance of RequestObject
     * @param expectedStatusCode
     * @return a boolean to indicate whether the response status code equals the expected one
     */
    @Keyword
    def verifyStatusCode(TestObject request, int expectedStatusCode) {
        if (request instanceof RequestObject) {
            RequestObject requestObject = (RequestObject) request
            ResponseObject response = WSBuiltInKeywords.sendRequest(requestObject)
            if (response.getStatusCode() == expectedStatusCode) {
                KeywordUtil.markPassed("Response status codes match")
            } else {
                KeywordUtil.markFailed("Response status code not match. Expected: " +
                        expectedStatusCode + " - Actual: " + response.getStatusCode() )
            }
        } else {
            KeywordUtil.markFailed(request.getObjectId() + " is not a RequestObject")
        }
    }

    /**
     * if a key is given make an object of objects by this data column key, otherwise make it an object of an array for each line
     * E.g. use method like such Map propertiesJSON = sampleKeywords.toJSONByKey(findTestData('Other/properties'),'env')
     * @param TestData
     * @param String
     * @return
     */
    @Keyword
    def toJSONByKey(TestData data,String key=null){
        String []columnNames = data.getColumnNames()
        JsonSlurper slurper = new JsonSlurper()

        Map dataJSON = key == null ? [:] : slurper.parseText('{}')

        for (def index : (1..data.getRowNumbers())){
            dataJSON[key == null ? index-1 : data.getValue(key, index)]=slurper.parseText('{}')
            for (def col : (1..data.getColumnNumbers())) {
                String columnName = columnNames[col-1]
                String cellValue = data.getValue(col,index).trim()
                dataJSON[key == null ? index-1 : data.getValue(key, index)][columnName]=cellValue
            }
        }
        return dataJSON
    }


    /**
     * Add Header basic authorization field,
     * this field value is Base64 encoded token from user name and password
     * @param request object, must be an instance of RequestObject
     * @param username username
     * @param password password
     * @return the original request object with basic authorization header field added
     */
    @Keyword
    def addBasicAuthorizationProperty(TestObject request, String username, String password) {
        if (request instanceof RequestObject) {
            String authorizationValue = username + ":" + password
            authorizationValue = "Basic " + authorizationValue.bytes.encodeBase64().toString()

            // Find available basic authorization field and change its value to the new one, if any
            List<TestObjectProperty> headerProperties = request.getHttpHeaderProperties()
            boolean fieldExist = false
            for (int i = 0; i < headerProperties.size(); i++) {
                TestObjectProperty headerField = headerProperties.get(i)
                if (headerField.getName().equals('Authorization')) {
                    KeywordUtil.logInfo("Found existent basic authorization field. Replacing its value.")
                    headerField.setValue(authorizationValue)
                    fieldExist = true
                    break
                }
            }

            if (!fieldExist) {
                TestObjectProperty authorizationProperty = new TestObjectProperty("Authorization",
                        ConditionType.EQUALS, authorizationValue, true)
                headerProperties.add(authorizationProperty)
            }
            KeywordUtil.markPassed("Basic authorization field has been added to request header")
        } else {
            KeywordUtil.markFailed(request.getObjectId() + "is not a RequestObject")
        }
        return request
    }


}