Анимация редко делает элемент буквально несуществующим всё время. Чаще тест сохраняет ссылку до rerender, кликает в момент `opacity: 0`, попадает в overlay или продолжает после появления DOM-узла, который ещё не интерактивен. Название исключения и screenshot в момент сбоя выбирают правильное ожидание.
Фиксированный sleep не знает, чего ждёт. На быстрой машине он только замедляет suite, на загруженном CI оказывается короче transition. Selenium рекомендует explicit wait: цикл проверяет конкретное условие и завершается сразу после его выполнения.
Исключение определяет следующий эксперимент
| Симптом/ошибка | Что происходит | Условие ожидания |
|---|---|---|
| NoSuchElement | Узел ещё не добавлен или locator неверен | presence с проверенным locator |
| ElementNotInteractable | Узел скрыт/не готов к вводу | visibility + enabled |
| StaleElementReference | DOM-узел заменён rerender | staleness, затем найти заново |
| ElementClickIntercepted | Центр закрыт overlay/другим узлом | overlay gone + hit test |
| TimeoutException | Условие не наступило | Лог последнего наблюдаемого состояния |
| Клик прошёл, эффект не наступил | Ждали кнопку, а не результат | Postcondition следующего состояния |
Сохраняйте page URL, locator, exception, screenshot, короткий DOM-фрагмент и состояние overlay. Видео удобно для человека, но автоматике нужен факт: какой элемент был верхним в точке клика, какая animation работала и менялся ли DOM.
Сначала используйте готовое Expected Condition
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 10)
open_button = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '[data-test=open-cart]')))
open_button.click()
# Следующая строка зависит от результата клика, поэтому ждём новый state:
wait.until(EC.visibility_of_element_located((By.CSS_SELECTOR, '[data-test=cart-dialog]')))Locator по стабильному data-test переживает перестановку классов лучше абсолютного XPath. `element_to_be_clickable` обычно проверяет видимость и enabled, но не знает бизнес-состояние приложения и может не увидеть краткое перекрытие. После действия ждите postcondition — например, dialog видим и заголовок обновлён — вместо предположения, что успешный click завершил переход.
Custom wait проверяет анимацию и точку клика
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
locator = (By.CSS_SELECTOR, '[data-test=save]')
def stable_click_target(driver):
el = driver.find_element(*locator) # на каждой попытке свежая ссылка
if not el.is_displayed() or not el.is_enabled():
return False
running, top = driver.execute_script('''
const el = arguments[0];
const r = el.getBoundingClientRect();
const x = r.left + r.width / 2;
const y = r.top + r.height / 2;
return [
el.getAnimations({subtree: true}).some(a => a.playState === 'running'),
document.elementFromPoint(x, y)
];
''', el)
return el if not running and (top == el or el.contains(top)) else False
button = WebDriverWait(driver, 10, poll_frequency=0.1).until(stable_click_target)
button.click()Element.getAnimations возвращает Animation-объекты элемента и, с subtree, его потомков. Hit test через elementFromPoint отвечает, кто реально находится в центре. Это условный вариант: sticky header, iframe, shadow DOM или намеренно кликабельный дочерний overlay могут требовать другой проверки. Ожидание не должно менять страницу — оно только наблюдает.
Ссылка на элемент живёт меньше компонента
Frontend может заменить кнопку другим DOM-узлом с тем же текстом после смены state. Сохранённый WebElement становится stale. Не оборачивайте click в бесконечный retry старой ссылки. Дождитесь staleness прежнего элемента, затем найдите новый по locator и снова проверьте готовность.
- Сохранить locator отдельно от найденного WebElement.
- После действия, вызывающего rerender, ожидать старое ожидаемое состояние или staleness.
- Внутри wait каждый раз вызывать find_element по locator.
- Ограничить общий timeout и добавить понятное сообщение.
- После клика подтвердить результат, а не только отсутствие exception.
- При timeout приложить последнее состояние и верхний элемент точки клика.
Implicit и explicit wait не смешиваются
Документация Selenium предупреждает: комбинация implicit и explicit waits приводит к непредсказуемому общему времени ожидания. Для suite с динамическим UI удобнее оставить implicit wait равным нулю или минимальному согласованному значению и явно ждать состояние в page object. Тогда TimeoutException сообщает, какая postcondition не наступила.
- Не ловите все исключения с повтором до бесконечности.
- Не увеличивайте общий timeout без графика фактической длительности.
- Не отключайте анимации только в тесте, если они меняют рабочую логику.
- Можно сократить motion в специальном режиме, но отдельный тест оставьте с production CSS.
- Не кликайте JavaScript-методом как постоянный обход перекрытия.
- Не используйте координаты, если есть стабильный семантический locator.
Flaky исправлен, когда условие объясняет продукт
Прогоните сценарий серией на локальной машине и в загруженном CI, меняя latency и prefers-reduced-motion. Запишите время ожидания как распределение, а не одно среднее. Если p95 вырос после релиза, тест может первым показать реальную деградацию интерфейса — не скрывайте её большим sleep.
Критерий готовности: тест ждёт конкретную видимость, исчезновение overlay или завершение rerender; failure содержит ожидаемое условие и фактический blocker; postcondition подтверждает результат клика. Для разбора нужны версия Selenium/driver/browser, locator, exception, screenshot и минимальная страница с transition — секреты и реальные пользовательские данные не нужны.