Selenium объявил о небольшом на первый взгляд изменении Java API с очевидными последствиями для совместимости. Начиная с планируемого выпуска Selenium 4.51, интерфейс ExpectedCondition<T> должен перестать расширять Guava com.google.common.base.Function<WebDriver, T>, сохранив при этом JDK-интерфейс java.util.function.Function<WebDriver, T>.
Это не повод паниковать или переходить на ещё не выпущенный артефакт. Напротив, это возможность выявить жёсткую привязку к зависимости до того, как изменение попадёт в обычный запрос на слияние с обновлением.
1. Что подтвердил Selenium
В официальном объявлении Selenium разделены затронутые и незатронутые варианты использования:
| Вариант использования | Ожидаемое влияние |
|---|---|
Результат фабричного метода ExpectedConditions передаётся непосредственно в WebDriverWait.until(...) | Не затронут |
ExpectedCondition реализован с помощью лямбда-выражения | Не затронут |
ExpectedCondition хранится или предоставляется через тип Guava Function | Несовместимость на этапе компиляции после удаления интерфейса |
Guava используется в других местах без связи с Selenium ExpectedCondition | Не относится к этому конкретному изменению |
На момент объявления изменение было запланировано для Selenium 4.51 и не выпускалось немедленно. Считайте эту версию лишь планируемой точкой изменения до появления официального артефакта выпуска и примечаний к выпуску.
Текущая документация Java API также полезна как исходная точка: в ней указано, что ExpectedCondition расширяет функциональные интерфейсы и Guava, и JDK. Это даёт командам конкретную основу для сравнения с будущим API.
2. Найдите реальную границу совместимости
Одного поиска Guava в дереве зависимостей недостаточно. Проект может обоснованно использовать Guava для других задач и при этом не быть затронутым. Важно определить, пересекают ли условия Selenium границу типов, объявленную как com.google.common.base.Function.
Начните с узкого поиска по коду:
git grep -n "com.google.common.base.Function"
git grep -n "ExpectedCondition\|ExpectedConditions"Проверьте совпадения в следующих местах:
- поля, в которых хранятся повторно используемые условия;
- вспомогательные методы, принимающие или возвращающие функциональный тип;
- обёртки тестового фреймворка над
WebDriverWait; - общие библиотеки, используемые несколькими репозиториями с тестами;
- точки расширения, доступные другим командам;
- скомпилированные сторонние вспомогательные библиотеки, которые могут предоставлять типы Guava в публичных сигнатурах.
Для каждого совпадения зафиксируйте владельца, потребителей и предлагаемый вариант миграции. Такая карта границ полезнее простого списка зависимостей: она показывает, где совместимое на уровне отдельного исходного файла изменение может нарушить работу зависимых потребителей.
3. Используйте минимальное безопасное изменение типа
Официальное направление миграции однозначно.
До изменения:
com.google.common.base.Function<WebDriver, WebElement> condition =
ExpectedConditions.elementToBeClickable(By.id("submit"));После изменения:
java.util.function.Function<WebDriver, WebElement> condition =
ExpectedConditions.elementToBeClickable(By.id("submit"));Если значение относится именно к Selenium, более выразительным вариантом будет:
ExpectedCondition<WebElement> condition =
ExpectedConditions.elementToBeClickable(By.id("submit"));Для короткой локальной переменной вывод типа позволяет устранить ненужную связанность:
var condition = ExpectedConditions.elementToBeClickable(By.id("submit"));Не добавляйте адаптеры с непроверяемыми преобразованиями типов только ради сохранения прежнего типа. Если публичная библиотека предоставляет Guava Function, изменение этой сигнатуры требует обычного планирования совместимости для её потребителей.
4. Подготовьтесь до выпуска, не создавая видимость тестирования
До появления официального совместимого артефакта команды могут выполнить полезную подготовительную работу:
- классифицировать все связанные с Selenium ссылки на Guava
Function; - рефакторить приватные детали реализации там, где намерение уже понятно;
- определить публичные API, изменение которых нужно согласовать с потребителями;
- добавить тесты для пользовательских обёрток ожиданий и обработки сбоев;
- задокументировать текущую заведомо рабочую версию Selenium;
- определить доказательства, необходимые для будущего обновления.
Не создавайте намеренно некомпилируемый тест с исключением из обычных сборок. Он почти ничего не доказывает. Ценная проверка — компиляция реальных наборов production- и тестового исходного кода с будущим официальным артефактом.
Долгоживущая ветка обновления также может устареть. Лучше создать короткоживущую контролируемую ветку обновления после выхода версии, заранее подготовив инвентаризацию и план тестирования.
5. План проверок на основе рисков
Когда станет доступна официальная версия Selenium с этим изменением, проводите обновление послойно:
| Риск | Доказательство |
|---|---|
| Явное использование типа Guava препятствует компиляции | Чистая компиляция всех наборов исходного кода приложения, тестов, фикстур и вспомогательных модулей |
| Изменение API общей обёртки нарушает работу потребителей | Контрактные тесты потребителей или сборки репрезентативных зависимых проектов |
| Поведение пользовательских ожиданий изменилось после рефакторинга | Целевые тесты успешного выполнения, тайм-аутов, игнорируемых исключений и возвращаемых значений |
| Разрешение зависимостей неожиданно изменилось | Сравнение деревьев зависимостей до и после обновления и проверки их согласованности |
| CI проходит успешно, хотя важный путь не протестирован | Репрезентативные браузерные smoke-тесты с последующим запуском обычного регрессионного набора |
| Собранный фреймворк по-прежнему предоставляет старую сигнатуру | Отчёт о совместимости публичного API или байт-кода собранного артефакта |
Объявленное удаление интерфейса создаёт прежде всего риск на этапе компиляции. Проверки времени выполнения остаются полезными, поскольку при устранении ошибок компиляции команды могут рефакторить обёртки. Однако в объявлении Selenium не утверждается, что изменится логика тайм-аутов ожиданий или обработки исключений.
6. Канареечная проверка фактического обновления в CI
Когда официальный артефакт станет доступен, создайте отдельное задание обновления или временную ветку:
- обновите только зависимость Selenium и внесите необходимые исправления типов;
- выполните чистую сборку с контролируемым состоянием кэшей зависимостей;
- скомпилируйте все релевантные наборы исходного кода, а не только основной модуль;
- запустите целевые тесты пользовательских ожиданий и обёрток;
- выполните небольшой набор браузерных smoke-тестов в стабильной среде;
- сохраните вывод компилятора, отчёты о зависимостях и результаты тестов как доказательства;
- запускайте полный регрессионный набор только после успешного прохождения предыдущих контрольных проверок.
Канареечная проверка наиболее полезна, когда использует те же файлы сборки, версию Java, образ раннера и общие библиотеки, что и основной конвейер. Успешный набор тестов приложения со старой зависимостью не подтверждает совместимость с новой зависимостью.
7. Защитите зависимых потребителей
Внутренние тестовые фреймворки часто превращают небольшое изменение внешней зависимости в более масштабную миграцию. Если общий метод сейчас возвращает Guava Function, найдите всех его потребителей до изменения сигнатуры.
Для каждой публичной границы решите, следует ли:
- выпустить согласованную версию с несовместимыми изменениями;
- добавить новый метод с типом JDK и объявить прежний метод устаревшим на определённый переходный период;
- сохранить в контракте тип
ExpectedCondition, специфичный для Selenium; - обновить всех контролируемых потребителей в одном окне изменений.
Правильный выбор зависит от распределения ответственности и политики выпуска. Главное требование QA — проверить контракт потребителей, а не только репозиторий фреймворка.
8. Прямое исправление и откат
Надёжное долгосрочное исправление — устранить связанную с Selenium зависимость от функционального интерфейса Guava. В зависимости от назначения API используйте тип JDK, специфичный для Selenium тип или вывод локального типа.
Откат должен быть столь же однозначным. До обновления зафиксируйте точную текущую заведомо рабочую версию Selenium. Если новая версия вызовет нерешённую проблему, восстановите эту точную версию и соответствующие изменения исходного кода, а затем снова выполните чистую сборку и smoke-проверки. Не используйте открытый диапазон версий как механизм защиты: он может выбрать более новый артефакт без осознанной проверки.
Откат — это временная мера управления риском, а не замена завершению миграции.
9. Контрольный список перед слиянием
- Проведена инвентаризация всех связанных с Selenium ссылок на Guava
Function. - Публичные и приватные границы типов классифицированы отдельно.
- Для обновления используется официальный выпущенный артефакт.
- Наборы исходного кода приложения, тестов, фикстур и вспомогательных модулей компилируются без ошибок.
- Проверены репрезентативные зависимые потребители.
- Протестированы успешные и неуспешные сценарии пользовательских ожиданий.
- Сравнены результаты разрешения зависимостей до и после обновления.
- Успешно пройдены браузерные smoke-тесты и необходимый объём регрессионного тестирования.
- Доказательства CI сохранены в запросе на слияние.
- Задокументированы точная версия для отката и ответственный.
- Проверка изменений соответствует обычной политике одобрения команды.
10. Пять вопросов для проверяющего
- Какие участки кода по-прежнему связывают
ExpectedConditionс GuavaFunction? - Проверили ли мы потребителей публичного API или только репозиторий, которому принадлежит обёртка?
- Компилирует ли задание CI каждый набор исходного кода, который может содержать вспомогательные компоненты Selenium?
- Какие тесты времени выполнения покрывают код, изменённый при миграции типов?
- Можем ли мы восстановить точную заведомо рабочую версию зависимости и подтвердить откат за один контролируемый запуск?
11. Где помогает автоматизация
Статический поиск делает первоначальную инвентаризацию воспроизводимой. Отчёты о зависимостях выявляют транзитивные изменения. Компиляция в CI обнаруживает детерминированные несовместимости, а контрактные тесты — нарушения у потребителей. Затем браузерные smoke-тесты проверяют поведение переработанных вспомогательных компонентов ожиданий.
Автоматизация не может решить, допустимо ли изменение публичного API, с какими потребителями необходимо согласовать изменения и достаточно ли собранных доказательств для выпуска. Эти решения по-прежнему требуют проверки человеком.
Заключение
Планируемое изменение ExpectedCondition в Selenium 4.51 невелико по объёму, но наглядно демонстрирует более общий урок для QA: при обновлении зависимостей необходимо проверять публичные границы типов, а не только сценарии времени выполнения. Точная инвентаризация, контролируемая ветка обновления, многоуровневые доказательства CI и точно определённая версия для отката позволяют устранить нежелательную связанность до того, как она заблокирует поставку.
Оставить комментарий
Поделитесь своим мнением о статье. Регистрация не требуется.
Комментарии
Загрузка комментариев…