Skip to content

v2.0.1

Latest

Choose a tag to compare

@serhatozdursun serhatozdursun released this 02 Oct 14:34
bfcadb9

Release Notes — v2.0.1

We are excited to announce version 2.1.0 of the Modern BDD Testing Framework, bringing powerful new capabilities to improve test resilience and reduce flakiness in automation projects.

✨ New Features

🤖 Self-Healing Locators

  • Introduced a Self-Healing Engine to recover from failing locators automatically.
  • Captures screenshots and DOM snapshots upon failure for detailed diagnostics.
  • Generates heuristic candidates (alternative XPaths and CSS selectors) based on step text, attributes, and DOM context.
  • Integrates with OpenAI (via GPT models) to suggest corrected locators and fix typos or minor mismatches.
  • Uses AI-powered fallback when heuristic recovery fails.
  • Supports shadow mode: logs suggested locators without applying them, for safe evaluation.
  • Maintains a ModelStore cache to reuse previously healed locators for faster test execution.

⚡ Enhancements

  • Added de-duplication for locator candidates using LinkedHashSet to eliminate redundant retries.

  • Configurable via config.properties:

    selfheal.enabled=true
    selfheal.shadow_mode=false
    selfheal.ai.enabled=true
  • AI integration requires OPENAI_API_KEY in the environment. If missing, AI-based suggestions are skipped to avoid unnecessary failures.

  • Extended detailed decision logging into reports/self-heal/ including DOM snapshots, screenshots, and locator resolution traces.

🔧 Bug Fixes

  • Fixed incorrect retry handling when implicit waits were temporarily overridden.
  • Fixed issue where duplicate candidate locators caused unnecessary retries.
  • Improved error handling when AI responses are malformed or API is unavailable.

🚀 Migration Notes

  • No breaking changes.
  • If selfheal.enabled=false, the framework continues to behave as before.
  • Enable selfheal.ai.enabled=true only when OPENAI_API_KEY is available in the environment.

📝 Next Steps

  • Planned integration with OCR/visual heuristics for advanced self-healing.
  • Extend AI suggestions to multi-element lookups (findElements).

Modern BDD Testing Framework v2.1.0 brings reliability and intelligence to test automation by combining heuristics with AI. This dramatically reduces flakiness from minor UI changes, saving engineering time and stabilizing pipelines.