Анимация редко делает элемент буквально несуществующим всё время. Чаще тест сохраняет ссылку до rerender, кликает в момент `opacity: 0`, попадает в overlay или продолжает после появления DOM-узла, который ещё не интерактивен. Название исключения и screenshot в момент сбоя выбирают правильное ожидание.

Фиксированный sleep не знает, чего ждёт. На быстрой машине он только замедляет suite, на загруженном CI оказывается короче transition. Selenium рекомендует explicit wait: цикл проверяет конкретное условие и завершается сразу после его выполнения.

Исключение определяет следующий эксперимент

Симптом/ошибкаЧто происходитУсловие ожидания
NoSuchElementУзел ещё не добавлен или locator неверенpresence с проверенным locator
ElementNotInteractableУзел скрыт/не готов к вводуvisibility + enabled
StaleElementReferenceDOM-узел заменён rerenderstaleness, затем найти заново
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 и снова проверьте готовность.

  1. Сохранить locator отдельно от найденного WebElement.
  2. После действия, вызывающего rerender, ожидать старое ожидаемое состояние или staleness.
  3. Внутри wait каждый раз вызывать find_element по locator.
  4. Ограничить общий timeout и добавить понятное сообщение.
  5. После клика подтвердить результат, а не только отсутствие exception.
  6. При 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 — секреты и реальные пользовательские данные не нужны.

Проверенные источники