Developer Documentation

Selenium Java SDK

v4.33.1 (2026-05-13)

Fixed

  • Fixed an issue where instantiating EvincedWebDriver could fail with NoClassDefFoundError: org/apache/hc/client5/http/ssl/TlsSocketStrategy (followed by a NullPointerException) when Apache HttpClient 5 was missing from your project or pinned to an older version (5.0.x / 5.1.x — older Selenium 4.x and some Spring stacks pull these older versions in transitively). The SDK now ships its own isolated copy of Apache HttpClient 5, so it is no longer affected by whichever version your project uses.

v4.32.0 (2026-05-07)

Added

  • Custom SSL trust store — attach an SSLContext to your EvincedConfiguration and pass the configuration to the EvincedWebDriver constructor; the SDK then trusts your internal root CA for all of its outbound HTTPS traffic (license validation, telemetry, component-recognition backends, and report uploads to the Evinced Platform). Removes the need to modify the JVM-wide truststore.

Changed

  • SDK network retries are skipped when the failure is a TLS trust error (PKIX path building failed and similar) on any outbound call. The SDK now logs a single actionable warning that points to the Custom SSL Trust Store configuration instead of retrying three times against the same broken trust chain.

v4.30.2 (2026-04-30)

Fixed

  • Fixed an issue where EvincedWebDriver could not find elements inside iframes, causing unexpected NoSuchElementException even when the same locator worked with a plain ChromeDriver.
  • Fixed an issue where switching to a popup window during an active session caused accessibility issues on the originating page to be missing from the report.
  • Fixed an issue where closing a popup or tab mid-session could cause subsequent analyses to return empty results.

v4.30.1 (2026-04-24)

Fixed

  • SDK logging now works reliably regardless of the customer application's logging setup — previously, depending on the libraries on the classpath, the configured log folder could end up empty or the SDK could go fully silent. The complete LoggingConfiguration API now behaves identically in any environment.

Security

  • Updates third-party logging libraries to their latest patch releases to address known vulnerabilities.

v4.30.0 (2026-04-01)

  • Added Coralogix analytics integration for SDK usage tracking and error monitoring.

v4.29.2 (2026-03-16)

  • Improved reliability of HTTP communication — automatic retry and consistent proxy and auth-error handling across all SDK network requests
  • HTTP client verbose logs are suppressed by default; opt in via httpClientLoggingEnabled

v4.29.1 (2026-02-10)

  • Add support for new Report Engine
  • Remove AxePassed support

v4.28.1 (2026-02-06)

  • Enhanced SPA Navigation Monitoring reliability
  • Switching to the engine 16.14.1

v4.27.1 (2026-02-01)

  • Performance: Implemented script batching to reduce browser round-trips by 50-66%
  • Optimize frame context tracking
  • Bug fixes: race conditions, redundant validations

v4.26.2 (2026-02-02)

  • Updated reports generators

v4.26.1 (2026-01-27)

  • Migrate from analysis-web-component to analysis-web v16.12.1
  • Issues include 508/EN regulation objects

v4.25.1 (2026-01-22)

  • Added SPA Navigation Tracking configuration for enhanced Single Page Application testing with BiDi
  • Update Selenium version to 4.40.0

vv4.24.4 (2026-01-14)

  • Added support for platform core labels

v4.24.3 (2026-01-12)

  • Fixed NullPointerException when proxy capability is not available

v4.24.2 (2025-12-30)

  • Performance improvements

v4.24.1 (2025-12-18)

  • Switching to the engine 16.3.4

v4.23.4 (2025-11-19)

  • Fixed OutOfMemoryError in HTML reports during parallel test execution

v4.23.3 (2025-11-19)

  • Move 'unitId' label to custom labels.

v4.23.2 (2025-11-17)

  • Augument provided WebDriver with BiDI capabilities

v4.23.1 (2025-11-17)

  • Enhanced parallel test execution - fixed session loss and added per-session executor isolation
  • Fixed iframe context issues - automatic context switching with performance optimization
  • Improved error handling - evStop() returns cached results when analysis fails

v4.22.4 (2025-11-13)

  • Enhance settled analysis process when engine is not present in the page

v4.22.3 (2025-11-12)

  • Add tracking of click action inside executeScript command

v4.22.2 (2025-11-07)

  • Added 'unitId' label.

v4.22.1 (2025-11-06)

  • Switching to the engine 15.23.0

v4.21.1 (2025-10-10)

  • Switching to the engine 15.16.14

v4.20.9 (2025-09-30)

  • Add engine information and performance logs

v4.20.8 (2025-09-26)

  • Update html report generator

v4.20.6 (2025-09-23)

  • bugfix: Multiple calls to get token

v4.20.5 (2025-09-17)

  • bugfix: Use correct keys for labels when upload to platform

v4.20.4 (2025-09-16)

  • Make settled analysis configurable with throttling

v4.20.3 (2025-09-15)

  • Handle findElement(s) commands when injection flow in progress.
  • Add support for console logging when Log4j2 cannot be used.

v4.20.1 (2025-09-10)

  • Switching to the engine 15.16.11
  • Fix missing fields in the report

v4.19.1 (2025-09-04)

  • Switching to the engine 15.16.10
  • Multiple labels per key for platform uploads.

v4.18.1 (2025-09-03)

  • Update continuous mode to support Selenium BiDi.
  • Add Support for Screenshot configuration.

v4.17.1 (2025-08-19)

  • Switching to the engine 15.16.5
  • Added includeHiddenIframeDomains configuration property to control analysis of hidden iframes.

v4.16.1 (2025-08-11)

  • Switching to the engine 15.16.2
  • Added component tester support

v4.15.2 (2025-07-29)

  • Add configurable analytics endpoint support for engine initialization.

v4.15.1 (2025-07-04)

  • Switching to the engine 15.8.4

v4.14.2 (2025-06-16)

  • Added Performance Measurement support.

v4.14.1 (2025-06-06)

  • Switching to the engine 15.3.0
  • Fixed null pointer exception

v4.13.1 (2025-05-30)

  • Switching to the engine 15.2.0
  • Fixed an issue with character decoding on Windows when running from the console.

v4.12.1 (2025-05-16)

  • Switching to the engine 15.1.1

v4.11.2 (2025-05-15)

  • Common module update

v4.11.1 (2025-04-04)

  • Switching to the engine 14.23.0
  • Changed reporters dependencies.
  • Enabled Support Iframe by default.

v4.10.3 (2025-03-24)

  • Minor improvements.

v4.10.2 (2025-03-18)

  • Async user action handling for alerts

v4.10.1 (2025-03-11)

  • Switching to the Analysis Web 14.20.1

v4.9.4 (2025-03-10)

  • Minor improvements

v4.9.3 (2025-02-25)

  • Extend RemoteWebDriver support

v4.9.2 (2025-02-17)

  • Add RemoteWebDriver support

v4.9.1 (2025-02-12)

  • Switching to the Analysis Web 14.19.0

v4.8.3 (2025-02-11)

  • Fix proxy parsing bug

v4.8.2 (2025-02-03)

  • Fix proxy/setCredentials bug

v4.8.1 (2025-01-31)

  • Switching to the Analysis Web 14.16.0

v4.7.3 (2025-01-27)

  • Update engine initialisation with licence data

v4.7.2 (2025-01-08)

  • Moved Error and Logs to common module

v4.7.1 (2025-01-02)

  • Switching to the Analysis Web 14.13.0

v4.6.3 (2024-12-25)

  • Token verification on sdk side

v4.6.2 (2024-12-21)

  • Start using java common web sdk

v4.6.1 (2024-11-26)

  • Switching to the engine 14.8.2

v4.5.7 (2024-11-26)

  • Remove dependency on webdrivermanager

v4.5.6 (2024-11-19)

  • Fix creating empty folder for log files

v4.5.4 (2024-11-18)

  • Add additional logging

v4.5.3 (2024-11-05)

  • Updating License info

v4.5.1 (2024-10-23)

  • Switching to the engine 14.4.1

v4.4.1 (2024-10-18)

  • Switching to the engine 14.3.0

v4.3.3 (2024-10-11)

  • Fix discrepancy between local and reports uploaded to platform

v4.3.2 (2024-10-10)

  • Screenshot bug fix

v4.3.1 (2024-10-08)

  • Minor bugfixes

v4.2.1 (2024-08-30)

  • Switching to the engine 13.2.0

v4.1.8 (2024-08-29)

  • Remove toggle to include issues collected by evAnalyze() into the aggregated report. Included by default.

v4.1.7 (2024-08-23)

  • Additional improvements

v4.1.6 (2024-08-15)

  • Issues collected by evAnalyze() can be included into the aggregated report

v4.1.5 (2024-08-13)

  • Update Duplicate filtering rules for issues

v4.1.4 (2024-07-29)

  • Move hardcoded values to separate classes

v4.1.3 (2024-07-15)

  • Minor improvements after migrating to engine 13.1.2

v4.1.2 (2024-07-10)

  • Update package files

v4.1.1 (2024-07-05)

  • Switching to the engine 13.1.2

v4.0.2 (2024-07-03)

  • Disable redundant report directory creation.

v4.0.1 (2024-06-25)

  • Driver change, stop supporting Selenium 3

v3.14.1 (2025-09-17)

  • Switching to the engine 15.16.14
  • bugfix: Use correct keys for labels when upload to platform

v3.13.1 (2025-09-10)

  • Switching to the engine 15.16.11
  • Fix missing fields in the report

v3.12.1 (2025-09-05)

  • Switching to the engine 15.16.10
  • Multiple labels per key for platform uploads.

v3.11.2 (2025-08-08)

  • Add configurable analytics endpoint support for engine initialization.

v3.11.1 (2025-07-04)

  • Switching to the engine 15.8.4

v3.10.1 (2025-06-06)

  • Switching to the engine 15.3.0
  • Fixed null pointer exception

v3.9.1 (2025-05-30)

  • Switching to the engine 15.2.0
  • Fixed an issue with character decoding on Windows when running from the console.

v3.8.1 (2025-05-16)

  • Switching to the engine 15.1.1

v3.7.2 (2025-05-16)

  • Common module update

v3.7.1 (2025-04-16)

  • Switching to the engine 14.23.0
  • Changed reporters dependencies.
  • Enabled Support Iframe by default.
  • Update engine initialisation with licence data
  • Token verification on sdk side
  • Start using java common web sdk
  • Add additional logging

v3.6.5 (2025-01-21)

  • Aggregated report contains issues collected by evAnalyze()

v3.6.4 (2024-11-05)

  • Updating License info

v3.6.3 (2024-07-30)

  • Minor improvements

v3.6.2 (2024-07-15)

  • Minor improvements after migrating to engine 13.1.2

v3.6.1 (2024-07-11)

  • Switching to the engine 13.1.2

v3.5.2 (2024-07-03)

  • Disable redundant report directory creation.

v3.5.1 (2024-06-25)

  • Switching to the engine 13.1.0

v3.4.5 (2024-06-24)

  • Json in Mobile format added.

v3.4.4 (2024-06-07)

  • Screenshots are added to json report.

v3.4.3 (2024-05-10)

  • Additional improvements to logging.

v3.4.2 (2024-04-17)

  • The Upload to the platform feature added.

v3.4.1 (2024-04-03)

  • Switching to the engine 12.2.2

v3.3.4 (2024-03-29)

  • Fix Axe KnowledgeBaseLink issue

v3.3.3 (2024-03-14)

  • Additional improvements

v3.3.2 (2024-03-13)

  • Additional improvements for saving reports

v3.3.1 (2024-03-07)

  • Switching to the engine 12.1.2

v3.2.2 (2024-02-27)

  • Adding new options for engine configuration.

v3.2.1 (2024-02-27)

  • Switching to the engine 11.1.0

v3.1.3 (2024-02-14)

  • Re-throw any exception that can appear while generating HTML report
  • Deprecate EvincedRuntimeException. EvincedSDKException should be used instead

v3.1.2 (2024-02-11)

  • Fix possible JS Exception on evStart

v3.1.1 (2024-02-11)

  • Fix HTML report generation for big amount of issues

v3.0.1 (2024-01-26)

  • Enable EvCore

v2.8.1 (2024-01-25)

  • Switching to the semantic engine 11.0.1

v2.7.2 (2023-12-18)

  • Add memory debugging utils enabled with system variable EV_MEMORY_FOOTPRINT=enable

v2.7.1 (2024-01-15)

  • Switching to the semantic engine 11.0.0

v2.6.1 (2023-12-25)

  • Add CSV reporting

v2.5.1 (2023-12-25)

  • Switching to the semantic engine 10.1.1

v2.4.2 (2023-12-04)

  • Workaround for stopAnalysis JavaScript Exception happening on page reload

v2.4.1 (2023-11-23)

  • Switching to the semantic engine 10.0.1

v2.3.2 (2023-11-02)

  • new method to add axe configurations rule .addRule

v2.3.1 (2023-10-17)

  • Exporting reports is added

v2.2.1 (2023-09-18)

  • Switching to the semantic engine 8.3.2

v2.1.1 (2023-08-25)

  • Switching to the semantic engine 8.2.0

v2.0.1 (2023-08-21)

  • Update WebDriverManager to support Chrome versions > 115
  • Switching to Java version 11

v1.35.4 (2023-08-14)

  • Implement the Screenshots feature to include screenshots to the reports.

v1.34.1 (2023-07-27)

  • Global Switch ON/OFF:
    • Protection of being used after evStart was called.
    • The Evinced behavior can be switched off with environment variable EV_SWITCH_ON=false .

v1.33.1 (2023-07-11)

  • Method setEnableScreenshots is added to class EvincedConfiguration.

v1.32.1 (2023-06-15)

  • Add explicit WebDriver parameter to evSaveFile method.

v1.31.1 (2023-06-09)

  • Switching to the semantic engine 8.1.0
    1. [UF] Upgrade axe version to 4.7.2 with minor bugfixes and improvements:
    • link-in-text-block Added needs review violations
    • aria-allowed-attr
    • aria-required-children
    • color-contrast

v1.30.4 (2023-06-08)

  • Remove some duplicates with absent code snippets
  • Switching to the semantic engine 8.0.0
    1. [UF] Revisited Accessible Name false positives for elements with IDs containing special characters when shadow DOM is supported
    2. [UF] Added Support for new evCore only validation 'Meaningless Alt Text'
    3. [UF] Upgrade axe version to 4.7.0 with minor bugfixes and improvements:
    • scrollable-region-focusable changed severity level from moderate to serious
    • aria-required-children
    • color-contrast
    • link-in-text-block

v1.20.1 (2023-04-25)

  • Switching to the semantic engine 7.4.0
    1. [UF] Fixed a crash when internal iframes finish loading before the main window
    2. [UF] Bugfix: Fix crashes when the Shadow DOM toggle is on

v1.19.1 (2023-04-18)

  • Removed unnecessary dependency on log4j package
  • Added environment variable EV_LOGGING_MODE=enable to switch internal logging on

v1.18.2 (2023-03-31)

  • Bug fix: Update Reporter to fix invoking deprecated method in Selenium 4.x

v1.18.1 (2023-03-31)

  • Bug fix: Adjust Reporter to work with Selenium 3.x and modern versions of Chrome

v1.17.3 (2023-03-07)

  • Switching to the semantic engine version 7.2.1
    • minor bugfix for SVGs at isInViewport calculation
    • enable comparison of EvCore with legacy enginges, toggle: ENABLE_EV_CORE_COMPARISON

v1.17.1 (2023-02-20)

  • Update knowledgeBaseLink functionality

v1.16.1 (2023-02-14)

  • Add possibility to update knowledgeBaseLink in configuration

v1.15.1 (2023-02-10)

  • Switching to the semantic engine version 7.2.0
    • [UF] Provide configuration to override issues' severity level. Usage:
      1CONFIG.CUSTOM_ISSUE_SEVERITY: {
      2  WRONG_SEMANTIC_ROLE: 'Low',
      3  'AXE-ARIA-ALLOWED-ROLE': 'High'
      4}
    • [UF] Provide configuration to override issue's severity names. Usage:
      1CONFIG.CUSTOM_SEVERITY_NAMES: {
      2  CRITICAL: 'High',
      3  SERIOUS: 'High',
      4  MINOR: 'Low'
      5}
    • [UF] Upgrade axe version to 4.6.3 with minor bugfixes and improvements to:
    • link-in-text-block
    • color-contrast
    • aria-required-children
    • scrollable-region-focusable
    • autocomplete-valid

v1.14.3 (2023-01-10)

  • Dependencies are removed from distribution jar.
  • The latest available versions of dependency packages are used.

v1.14.1 (2023-01-04)

  • Switching to the semantic engine version 6.0.0
    1. Delete Evinced "Broken Skip Link" validation
    2. Released a new Evinced validation: "Language Attribute Mismatch"
    3. Improved "Language Attribute Mismatch" validation
    4. Renamed "Text on Image" validation to "Text Contrast on Compound Background" and updated description
    5. Bugfix: Added disabled attribute handling

v1.13.1 (2022-12-28)

  • API change: Added ability to switch on/off Evinced functionality EvincedSDK.switchOn(false).
  • Fix for missed issues on the last page that could happen sometines.

v1.12.1 (2022-12-23)

  • Command evStop will return only issues found between evStart and evStop.
  • New boolean configuration option useGlobalPersistentData is added to keep previous behavior of evStop command.
  • API change (backward compatible): EvincedSDK is made utility class EvincedSDK.getInstance().setCredentials() -> EvincedSDK.setCredentials()

v1.11.1 (2022-12-20)

  • Javadocs are added

v1.10.1 (2022-12-13)

  • Support both versions of Selenium WebDriver 3.x and 4.x
  • Remove Selenium WebDriver package from SDK jar and transitive dependencies

v1.9.1 (2022-12-02)

  • New method evSaveFile(String filename, FileFormat format) is added to save aggregated report.
  • Multithreading mode is supported.

v1.8.6 (2022-11-17)

  • Support of Firefox browser is added

v1.8.5 (2022-11-17)

  • Update sarif report generator
  • Update semantic engine version 4.0.0

Ignore validations for dynamically created href (false pos)

v1.8.3 (2022-11-04)

  • Update semantic engine version 3.2.2

    Added page visit usage counter

v1.8.2 (2022-11-03)

  • Update semantic engine version 3.2.1

    Get tenant name from license token (usage)

v1.8.1 (2022-10-31)

Breaking API Changes:

  • Order of parameters for methods
1-    public void setOfflineCredentials(String authToken, String serviceId) {
2+    public void setOfflineCredentials(String serviceId, String authToken) {
3

4-    public void setCredentials(String secret, String serviceId) {
5+    public void setCredentials(String serviceId, String secret) {

v1.7.2 (2022-10-31)

  • Correct default internal configuration of feature flags

v1.7.1 (2022-10-25)

  • Save running state in multiple driver runs

v1.6.1 (2022-10-18)

  • Update semantic engine version 3.1.2

    Fix bounding box calculation

v1.5.1 (2022-10-18)

  • Add sarif report

v1.4.1 (2022-10-05)

  • Update html report generator

v1.3.1 (2022-09-20)

  • Added logging api for server configuration

v1.2.1 (2022-09-20)

  • Added licensing

v1.1.1 (2022-09-01)

  • Added API to skip validations to tune engine validators settings

v1.0.1 (2022-08-15)

  • Support of single run mode with evAnalyze() command.
  • Support of flow mode with evStart() and evStop() commands.
  • evReport() command to store report in JSON or HTML(v2) format.
  • Iframes support.
  • Shadow DOM support.
  • Semantic engine version 2.0.0
    1. Introducing a new validation: missing focus indication
    2. Rename validation: from now on, focus indication will be called insufficient focus indication
    3. HTML report rebranding