Skip to content

fix: show root cause for initialization failures - #45

Merged
shossain786 merged 1 commit into
seleniumboot:masterfrom
mdraza7544:bug/42-initialization-failure-cause
Sep 12, 2026
Merged

shossain786 merged 1 commit into
seleniumboot:masterfrom
mdraza7544:bug/42-initialization-failure-cause

Conversation

@mdraza7544

Copy link
Copy Markdown
Contributor

What & why

Fixes #42

When Selenium Boot fails during framework initialization, the user currently gets a generic error message without an easy way to see what actually caused the failure.

This makes configuration and environment problems harder to diagnose, especially when running tests through Maven or CI.

Changes

  • Expose the underlying initialization exception before the suite is aborted.
  • Keep the existing high-level Selenium Boot initialization error message.
  • Make the original failure and its cause available in the test output.
  • Keep the change focused on framework initialization error handling.

Type of change

  • Bug fix
  • New feature (opt-in, aligned with the framework philosophy)
  • Documentation
  • Internal refactor / test coverage

Checklist

  • The change is limited to the initialization failure handling.
  • The original exception is preserved.
  • The existing initialization failure message is retained.
  • No unrelated framework behavior was changed.

Notes for reviewers

The goal of this change is to make initialization failures easier to diagnose.

Previously, a bootstrap failure could surface only as:

Selenium Boot failed to initialize. Aborting test suite execution.

The underlying exception is now exposed so users can see the actual reason for the initialization failure and troubleshoot it without having to inspect the source code.

@shossain786

Copy link
Copy Markdown
Contributor

Nice catch on #42 and a clean fix — this looks good. Merging it.

@shossain786
shossain786 merged commit ee0d087 into seleniumboot:master Sep 12, 2026
2 checks passed
@shossain786 shossain786 mentioned this pull request Sep 19, 2026
2 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Framework initialization failures never surface their real cause

2 participants