How to extract and verify textual patterns in a test case

In a test project, you might want to verify that the application under test (AUT) displays information in the correct pattern, such as email, phone number, or price tag pattern. Katalon Recorder supports this pattern matching process with several commands. Specifically, commands in Katalon Recorder can take patterns as input to verify several data types on an AUT.

This tutorial shows you how to extract and verify displayed text on an AUT. The pattern used in our case is a regular expression (regex): a sequence of characters that specifies a search pattern.

In our example, we have a scenario "extract and verify item price," which consists of these steps:

  1. Sign in to the AUT - Katalon Zack Market:
  2. Navigate to the homepage:
  3. On the homepage, select an item.
  4. On the item details page, extract the item price.
  5. Verify that the item price is in the correct pattern: a currency symbol ($) followed by a numeric value.

After we follow the first three steps of the scenario, the item details page displays the price text as follows:

Katalon Recorder AUT overview

Click the image to enlarge

We can see that the price text consists of the item price ($25.99) and the currency code (CAD).

Extract and verify textual patterns

To complete the last two steps of the scenario, we create a test case to extract only the price from the displayed price text. Then, we verify that the price is in the correct pattern using a regex.

Follow these steps:

  1. In Katalon Recorder, create a new test case.

    Katalon Recorder new test case
  2. Store the displayed price text. We want to store the price text into a variable.

    To do so, we use the storeText command.

    Katalon Recorder storeText command

    Next, we need to capture the Target (the price text locator) for the command. Click on the Capture tool, then hover the cursor over and select the price text on the page.

    Katalon Recorder capture target

    In our case, the captured locator is the XPath: xpath=//div[@id='root']/div/div/div/div[2]/div/div[2]/div/div[3]. We then store the text into the displayedPrice variable.

    Katalon Recorder complete storeText command
  3. Extract the item price.

    We use the storeEval command to extract the item price $25.99 (the first six characters) from the text.

    Katalon Recorder storeEval command with a Javascript expression

    The storeEval command evaluates a Javascript expression, then stores the result into a variable. In our example, the target Javascript expression is "${displayedPrice}".substring(0, 6). Here, substring() is a method that extracts characters from a string, given two indices.

    The expression evaluates the displayedPrice variable into its value. Then it extracts and stores the first six characters into the itemPrice.

  4. Verify the item price with regex.

    We use the verifyEval command with a regex in the Value field. This command verifies that the item price is displayed in the correct price pattern.

    Katalon Recorder verifyEval command with a Javascript expression and regular expression

    To input a regex as a value, we prefix the expression with regexp:. For our purpose, we use the regex ^[$](\d+\.\d+) that checks if the item price starts with a dollar sign and ends with a numeric value.

  5. Play the test case and verify the results in the Log view.

    Katalon Recorder Log view results

    Click the image to enlarge