release: v3.2.0 — WaitEngine attributeToBe, urlMatches, textMatches

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -32,7 +32,7 @@ body:
     id: sb-version
     attributes:
       label: Selenium Boot version
-      placeholder: "3.1.1"
+      placeholder: "3.2.0"
     validations:
       required: true
   - type: input

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+### v3.2.0 — 2026-07-18
+
+- **Three new `WaitEngine` conditions**, consistent with the existing `waitFor*` naming:
+  - `waitForAttribute(By, attribute, value)` — waits for an exact attribute match (use the existing `waitForAttributeContains` for a substring match)
+  - `waitForUrlMatches(String regex)` — waits for the current URL to match a regular expression (use the existing `waitForUrlContains` for a substring match)
+  - `waitForTextMatches(By, String regex)` — waits for an element's visible text to match a regular expression
+  - Purely additive to the `@SeleniumBootApi` surface — no breaking changes. (Closes #12)
+
 ### v3.1.1 — 2026-06-26
 
 - **Per-engine report output directory** — the metrics JSON, HTML report, and metrics history now honor the `seleniumboot.reports.dir` system property (the same switch already used for the JUnit XML report), defaulting to `target` as before. This fixes the HTML report being **overwritten** when two test engines run in one build — e.g. a TestNG suite (Surefire) and JUnit 5 tests (Failsafe): point each engine's run at its own directory (`-Dseleniumboot.reports.dir=target/junit5`) and each produces a self-contained report instead of the last one clobbering the first.

README.md

@@ -86,7 +86,7 @@ Add to your `pom.xml`:
 <dependency>
     <groupId>io.github.seleniumboot</groupId>
     <artifactId>selenium-boot</artifactId>
-    <version>3.1.1</version>
+    <version>3.2.0</version>
 </dependency>
 ```
 
@@ -652,7 +652,7 @@ ci:
 
 ## Project Status
 
-**Current release: v3.1.1** — per-engine report output dir (`seleniumboot.reports.dir`), fixing report overwrites when TestNG + JUnit 5 run in one build.
+**Current release: v3.2.0** — three new `WaitEngine` conditions: `waitForAttribute` (exact-match attribute), `waitForUrlMatches`, and `waitForTextMatches` (regex).
 
 See the full version history in **[CHANGELOG.md](CHANGELOG.md)**.
 

docs-site/docs/changelog.md

@@ -11,6 +11,17 @@ All notable changes to Selenium Boot are documented here.
 
 ---
 
+## [3.2.0] — 2026-07-18
+
+### Added
+- **Three new `WaitEngine` conditions**, consistent with the existing `waitFor*` naming:
+  - `waitForAttribute(By, attribute, value)` — waits for an exact attribute match (see `waitForAttributeContains` for a substring match).
+  - `waitForUrlMatches(String regex)` — waits for the current URL to match a regular expression (see `waitForUrlContains` for a substring match).
+  - `waitForTextMatches(By, String regex)` — waits for an element's visible text to match a regular expression.
+  - Purely additive to the `@SeleniumBootApi` surface — no breaking changes.
+
+---
+
 ## [3.1.1] — 2026-06-26
 
 ### Fixed

docs-site/docs/getting-started.md

@@ -35,7 +35,7 @@ No WebDriver binaries required — Selenium Manager handles browser driver downl
 <dependency>
     <groupId>io.github.seleniumboot</groupId>
     <artifactId>selenium-boot</artifactId>
-    <version>3.1.1</version>
+    <version>3.2.0</version>
 </dependency>
 ```
 
@@ -44,7 +44,7 @@ No WebDriver binaries required — Selenium Manager handles browser driver downl
 
 ```groovy title="build.gradle"
 dependencies {
-    testImplementation 'io.github.seleniumboot:selenium-boot:3.1.1'
+    testImplementation 'io.github.seleniumboot:selenium-boot:3.2.0'
 }
 
 test {
@@ -58,7 +58,7 @@ test {
 
 ```kotlin title="build.gradle.kts"
 dependencies {
-    testImplementation("io.github.seleniumboot:selenium-boot:3.1.1")
+    testImplementation("io.github.seleniumboot:selenium-boot:3.2.0")
 }
 
 tasks.test {

docs-site/docs/junit5.md

@@ -17,7 +17,7 @@ Selenium Boot supports both **TestNG** (built-in) and **JUnit 5** (opt-in). The
 <dependency>
     <groupId>io.github.seleniumboot</groupId>
     <artifactId>selenium-boot</artifactId>
-    <version>3.1.1</version>
+    <version>3.2.0</version>
 </dependency>
 
 <dependency>

docs-site/docs/migration/from-selenium-testng.md

@@ -26,7 +26,7 @@ Remove your Selenium, WebDriverManager, and reporting dependencies and add one:
 <dependency>
     <groupId>io.github.seleniumboot</groupId>
     <artifactId>selenium-boot</artifactId>
-    <version>3.1.1</version>
+    <version>3.2.0</version>
 </dependency>
 ```
 

docs-site/src/pages/index.js

@@ -241,7 +241,7 @@ export default function Home() {
                 code={`<dependency>
   <groupId>io.github.seleniumboot</groupId>
   <artifactId>selenium-boot</artifactId>
-  <version>3.1.1</version>
+  <version>3.2.0</version>
 </dependency>`}
               />
             </div>

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.github.seleniumboot</groupId>
     <artifactId>selenium-boot</artifactId>
-    <version>3.1.1</version>
+    <version>3.2.0</version>
     <packaging>jar</packaging>
 
     <name>Selenium Boot</name>