Katalon Sealights Test Listener

This plugin integrates with Sealights and the Katalon Sealights Integration Plugin to optimize test execution by skipping tests that Sealights has determined don't need to be run based on code changes.

Features

• Automatically skips test cases marked as excluded by Sealights analysis
• Works with Katalon Studio static test suites
• Compatible with both UI and command-line execution

Prerequisites

• Katalon Studio 9.6+
• Sealights Integration Plugin v2.0+
• Valid Sealights configuration in project settings

Installation

1. Install the Sealights Integration Plugin (v2.0+) from the Katalon Store or locally.
2. Install this plugin.

Usage

1. Configure your Sealights connection as desribed in the Sealights Integration Plugin documentation.

2. Create your static test suites as normal.

3. The listener will automatically:

• Load the excluded tests list at the start of each test suite
• Skip any test cases that Sealights has determined don't need to be run

Command Line Execution

The listener works with both UI and command-line execution. For command line, use your normal Katalon command with Sealights configuration:

katalonc -noSplash -runMode=console \
  -projectPath="/path/to/project.prj" \
  -testSuitePath="Test Suites/MyTestSuite" \
  -browserType="Chrome" \
  -sealightsUrl="https://sealights-server" \
  -sealightsAgentToken="your-token"
  -sealightsEnableListener

Logging

The listener provides logging for:

• Test suite start
• Loading of exclusion configuration
• Skipped test cases
• Configuration/loading errors

Troubleshooting

Common issues:

1. Missing configuration file

• Ensure sealights_excluded_tests.json exists in the correct location
• Check file permissions

1. Invalid JSON format

• Verify the JSON structure matches the example above
• Check for syntax errors

1. Sealights connection issues

• Verify your Sealights plugin configuration
• Check network connectivity to Sealights server

License

This plugin is licensed under the same terms as the Katalon Sealights Plugin.