Full Docs · Javadoc · Report Bug · Request Feature

Spectrum is an e2e test automation framework that leverages JUnit 5 and Selenium 4 to provide these features automatically:

• Driver management
• Auto-waiting before interacting with elements, to highly reduce flakiness
• Html report generation with the execution video
• Coverage report generation by reading a testbook
• Mail/Slack notifications with reports as attachments
• It is fully configurable via a declarative yaml file
• It provides out-of-the-box defaults to let you run tests with no additional configuration
• It supports browsers automation via Selenium
• It supports mobile and desktop applications automation via Appium
• It generates several additional reports that are fully customisable

Spectrum manages all the boilerplate code, allowing you to focus on test logic: you just need to write a JUnit test using the native Selenium API as you would do in a vanilla Selenium test, and Spectrum will enrich your suite transparently. Be sure to check the full documentation to see all the available features.

⚠️ Spectrum requires Java 21 or newer.

The easiest way is to take the three steps listed below, as shown in this video:

1. Generate a new project leveraging the Spectrum Archetype:

   mvn archetype:generate -DarchetypeGroupId=io.github.giulong -DarchetypeArtifactId=spectrum-archetype
   

2. Run the LoginFormIT demo test.

3. Check the report generated in target/spectrum/reports/spectrum-report-<TIMESTAMP>/spectrum-report-<TIMESTAMP>.html.

⚠️ Tests run on Chrome by default. As shown in the video above, you can change this with:
-Dspectrum.driver=firefox, -Dspectrum.driver=edge or -Dspectrum.driver=safari

If you like Spectrum, please consider giving it a GitHub Star ⭐

If you'd rather add Spectrum manually to your project, you just need to add its dependency:

<dependency>
    <groupId>io.github.giulong</groupId>
    <artifactId>spectrum</artifactId>
    <version>1.23.0</version>
    <scope>test</scope>
</dependency>

dependencies {
  implementation group: 'io.github.giulong', name: 'spectrum', version: '1.23.0'
}

Here's an overview of the project created by the archetype, along with the generated report and video:

 

You can also configure Spectrum to produce additional reports, such as summary and coverage:

 

Contributions to Spectrum are welcome! If you're interested, please check out the CONTRIBUTING.md and the open issues.

Spectrum leverages these projects you should definitely check out!

• JUnit 5
• Selenium
• Appium
• Lombok
• Extent Reports
• FreeMarker
• Simple Java Mail
• JCodec
• VicTools JsonSchema Generator
• Jekyll
• Modernist Theme
• Datafaker