Selenium hat eine scheinbar kleine Änderung an der Java-API angekündigt, die eindeutige Folgen für die Kompatibilität hat. Ab dem geplanten Release Selenium 4.51 soll ExpectedCondition<T> die Guava-Schnittstelle com.google.common.base.Function<WebDriver, T> nicht mehr erweitern und nur noch die JDK-Schnittstelle java.util.function.Function<WebDriver, T> verwenden.

Das ist weder ein Grund zur Panik noch dazu, auf ein noch nicht verfügbares Artefakt zu aktualisieren. Es ist eine Gelegenheit, Kopplungen an Abhängigkeiten zu identifizieren, bevor die Änderung Bestandteil eines regulären Upgrade-Pull-Requests wird.

1. Was Selenium bestätigt hat

Die offizielle Selenium-Ankündigung unterscheidet zwischen betroffenen und nicht betroffenen Verwendungsmustern:

VerwendungsmusterErwartete Auswirkung
Das Ergebnis einer ExpectedConditions-Factory-Methode wird direkt an WebDriverWait.until(...) übergebenNicht betroffen
Eine ExpectedCondition wird mit einem Lambda-Ausdruck implementiertNicht betroffen
Eine ExpectedCondition wird über den Guava-Typ Function gespeichert oder bereitgestelltInkompatibilität zur Compile-Zeit, nachdem die Schnittstelle entfernt wurde
Guava wird an anderer Stelle verwendet, ohne mit Seleniums ExpectedCondition verbunden zu seinLiegt außerhalb des Umfangs dieser konkreten Änderung

Zum Zeitpunkt der Ankündigung war die Änderung für Selenium 4.51 vorgesehen und sollte nicht sofort veröffentlicht werden. Behandeln Sie diese Version als geplante Kompatibilitätsgrenze, bis ein offizielles Release-Artefakt und die zugehörigen Release Notes verfügbar sind.

Auch die aktuelle Dokumentation der Java-API ist als Ausgangsbasis hilfreich: Sie zeigt, dass ExpectedCondition derzeit sowohl die funktionale Guava-Schnittstelle als auch die entsprechende JDK-Schnittstelle erweitert. Damit steht Teams eine konkrete Referenz für den Vergleich mit der zukünftigen API zur Verfügung.

2. Die tatsächliche Kompatibilitätsgrenze ermitteln

Es reicht nicht aus, den Abhängigkeitsbaum nach Guava zu durchsuchen. Ein Projekt kann Guava berechtigterweise für andere Funktionen verwenden und dennoch von dieser Änderung unberührt bleiben. Entscheidend ist, ob Selenium-Bedingungen eine Typgrenze überschreiten, die als com.google.common.base.Function deklariert ist.

Beginnen Sie mit einer gezielten Code-Suche:

git grep -n "com.google.common.base.Function"
git grep -n "ExpectedCondition\|ExpectedConditions"

Prüfen Sie Treffer insbesondere an folgenden Stellen:

Dokumentieren Sie für jeden Treffer die verantwortliche Person, die Nutzer des betroffenen Codes und den vorgesehenen Migrationsweg. Diese Übersicht der Typgrenzen ist hilfreicher als eine reine Liste von Abhängigkeiten, da sie zeigt, an welchen Stellen eine auf Quellcodeebene kompatible Änderung zu einem Breaking Change für nachgelagerte Nutzer werden könnte.

3. Die kleinste sichere Typänderung verwenden

Der offiziell empfohlene Migrationsweg ist unkompliziert.

Vorher:

com.google.common.base.Function<WebDriver, WebElement> condition =
    ExpectedConditions.elementToBeClickable(By.id("submit"));

Nachher:

java.util.function.Function<WebDriver, WebElement> condition =
    ExpectedConditions.elementToBeClickable(By.id("submit"));

Wenn der Wert spezifisch für Selenium ist, bietet sich eine ausdrucksstärkere Alternative an:

ExpectedCondition<WebElement> condition =
    ExpectedConditions.elementToBeClickable(By.id("submit"));

Bei einer kurzlebigen lokalen Variable kann die Typinferenz eine unnötige Kopplung vermeiden:

var condition = ExpectedConditions.elementToBeClickable(By.id("submit"));

Führen Sie keine ungeprüften Adapter ein, nur um den bisherigen Typ beizubehalten. Wenn eine öffentliche Bibliothek Guava Function bereitstellt, muss eine Änderung dieser Signatur im Rahmen der üblichen Kompatibilitätsplanung für ihre Nutzer erfolgen.

4. Vor dem Release vorbereiten, ohne einen Test vorzutäuschen

Noch bevor ein offizielles kompatibles Artefakt verfügbar ist, können Teams sinnvolle Vorbereitungen abschließen:

Erstellen Sie keinen absichtlich nicht kompilierbaren Test, der anschließend aus regulären Builds ausgeschlossen wird. Ein solcher Test besitzt nur geringe Aussagekraft. Entscheidend ist, die tatsächlichen Produktions- und Test-Source-Sets gegen das zukünftige offizielle Artefakt zu kompilieren.

Auch ein langlebiger Upgrade-Branch kann veralten. Bevorzugen Sie deshalb einen kurzlebigen, kontrollierten Upgrade-Branch, sobald das Release verfügbar ist. Halten Sie das Inventar und den Testplan jedoch bereits im Voraus bereit.

5. Risikobasierter Verifikationsplan

Sobald eine offizielle Selenium-Version mit dieser Änderung verfügbar ist, sollte das Upgrade schrittweise geprüft werden:

RisikoNachweis
Eine direkte Typisierung mit Guava verhindert die KompilierungSaubere Kompilierung aller Produktions-, Test-, Fixture- und Helper-Source-Sets
Die öffentliche API eines gemeinsam genutzten Wrappers beeinträchtigt ihre NutzerConsumer-Contract-Tests oder Builds repräsentativer nachgelagerter Projekte
Benutzerdefinierte Waits verhalten sich nach dem Refactoring andersGezielte Tests für erfolgreiche Ausführung, Timeouts, ignorierte Exceptions und Rückgabewerte
Die Auflösung von Abhängigkeiten ändert sich unerwartetVergleich der Abhängigkeitsbäume vor und nach dem Upgrade sowie Konvergenzprüfungen
Die CI ist erfolgreich, obwohl ein wichtiger Pfad nicht getestet wurdeRepräsentative Browser-Smoke-Tests mit anschließender regulärer Regressionstestsuite
Das gebaute Framework stellt weiterhin eine alte Signatur bereitBericht zur Kompatibilität der öffentlichen API oder des Bytecodes des erstellten Artefakts

Die angekündigte Entfernung der Schnittstelle stellt in erster Linie ein Risiko zur Compile-Zeit dar. Laufzeitprüfungen bleiben dennoch wichtig, da Teams bei der Behebung von Kompilierungsfehlern möglicherweise ihre Wrapper refaktorieren. Die Selenium-Ankündigung selbst beschreibt jedoch keine Änderung am Timing der Waits oder am Verhalten bei Exceptions.

6. CI-Canary für das tatsächliche Upgrade

Erstellen Sie einen separaten Upgrade-Job oder einen temporären Branch, sobald das offizielle Artefakt verfügbar ist:

Ein Canary liefert den größten Nutzen, wenn er dieselben Build-Dateien, dieselbe Java-Version, dasselbe Runner-Image und dieselben gemeinsam genutzten Bibliotheken wie die reguläre Pipeline verwendet. Eine erfolgreiche Anwendungstestsuite mit der bisherigen Abhängigkeit ist kein Nachweis dafür, dass die neue Abhängigkeit kompatibel ist.

7. Nachgelagerte Nutzer schützen

Interne Testframeworks können aus einer kleinen Upstream-Änderung eine umfangreichere Migration machen. Wenn eine gemeinsam genutzte Methode derzeit Guava Function zurückgibt, müssen ihre Nutzer vor einer Änderung der Signatur identifiziert werden.

Entscheiden Sie für jede öffentliche Typgrenze, ob Sie:

Die richtige Entscheidung hängt von den Verantwortlichkeiten und der Release-Richtlinie ab. Aus QA-Sicht ist entscheidend, den Vertrag mit den Nutzern zu testen und nicht nur das Repository des Frameworks.

8. Forward Fix und Rollback

Die dauerhafte Lösung besteht darin, Selenium-bezogene Abhängigkeiten von der funktionalen Guava-Schnittstelle zu entfernen. Verwenden Sie je nach Zweck der API bevorzugt den JDK-Typ, den Selenium-spezifischen Typ oder die lokale Typinferenz.

Auch der Rollback muss eindeutig definiert sein. Dokumentieren Sie vor dem Upgrade die exakte aktuell bekannte funktionierende Selenium-Version. Falls die neue Version ein ungelöstes Problem verursacht, stellen Sie diese exakte Version und die dazu passenden Quellcodeänderungen wieder her. Führen Sie anschließend den sauberen Build und die Smoke-Tests erneut aus. Verwenden Sie keinen offenen Versionsbereich als Sicherheitsmechanismus, da dadurch ohne bewusste Prüfung ein neueres Artefakt ausgewählt werden kann.

Ein Rollback ist eine vorübergehende Maßnahme zur Risikokontrolle und kein Ersatz für den Abschluss der Migration.

9. Checkliste vor dem Merge

10. Fünf Fragen für Reviewer

11. Wo Automatisierung hilft

Statische Suchen machen die anfängliche Bestandsaufnahme wiederholbar. Abhängigkeitsberichte zeigen transitive Änderungen auf. Die Kompilierung in der CI erkennt deterministische Inkompatibilitäten, während Contract-Tests fehlerhafte Verträge mit Nutzern sichtbar machen. Anschließende Browser-Smoke-Tests prüfen das Verhalten der refaktorierten Wait-Hilfsklassen.

Automatisierung kann nicht entscheiden, ob eine Änderung an einer öffentlichen API akzeptabel ist, mit welchen Nutzern sie abgestimmt werden muss oder ob die gesammelten Nachweise für das Release ausreichen. Diese Entscheidungen erfordern weiterhin ein menschliches Review.

Fazit

Die geplante Änderung an ExpectedCondition in Selenium 4.51 ist eng begrenzt, verdeutlicht jedoch eine allgemeinere QA-Erkenntnis: Bei Dependency-Upgrades müssen öffentliche Typgrenzen und nicht nur Laufzeitszenarien getestet werden. Ein präzises Inventar, ein kontrollierter Upgrade-Branch, mehrstufige CI-Nachweise und ein exakt definiertes Rollback-Ziel ermöglichen es Teams, die Kopplung zu beseitigen, bevor sie die Auslieferung blockiert.

Quellen