ИИ может быстро составить тест на Selenium. QA‑шлюз определяет, является ли этот тест актуальным, наблюдаемым, достаточно повторяемым для просмотра и безопасным для слияния.


Почему Selenium, созданный искусственным интеллектом, нужен отдельный шлюз проверки

Текущие рекомендации Selenium выявляют повторяющуюся проблему: кодирующие агенты часто воспроизводят шаблоны Selenium 2 или Selenium 3, потому что старые учебники всё ещё доминируют в обучающих материалах. Типичный вывод включает сторонний менеджер драйверов, жёстко закодированный путь драйверов, удаленные find_element_by_* помощники, DesiredCapabilities, абсолютный XPath или фиксированный сон. [1] [2]

Эти проблемы не являются доказательством того, что ИИ должен быть исключён из автоматизации тестирования. Они свидетельствуют о том, что сгенерированный код требует тех же правил адаптации, текущей документации, доказательств выполнения и человеческого контроля, что и новый участник.

Описанные ниже ворота — это рекомендация TestAI Lab, а не функция продукта Selenium. Официальная документация Selenium содержит актуальные технические правила. Команда владеет критериями принятия и решением о слиянии.


Что должно сразу же не пройти проверку

Сгенерированный паттернРешение о пересмотреТекущее направление
webdriver-manager или скачанный драйверный путьОтклоняйте, если проект не документирует конкретное исключениеSelenium Manager поставляется с Selenium и используется для автоматизированного управления драйверами. [1] [3]
DesiredCapabilities или свободные карты возможностей для нового кодаОтклонитьНастройте браузер через его класс Options.[1]
find_element_by_id или другой помощник find_element_by_*ОтклонитьИспользуйте driver.find_element(By.ID, "...") или другую By стратегию. [1]
time.sleep(...) использовался для синхронизации тестаОтклонитьЖдите конкретного условия, которое должно сбыться. [1] [2] [4]
Absolute XPath скопирован из DevToolsОтклонитьПроверьте реальный DOM и выберите наиболее стабильный доступный локатор, желательно тестовый атрибут, принадлежащий приложению, или другой надёжный идентификатор. [1] [2]
CDP-код представлен как кроссбраузерный стандарт по умолчаниюОтвергнуть или явно сузить сферу действияПредпочитайте WebDriver BiDi на основе стандартов, где необходимая функция поддерживается текущим браузером, связкой и версией Selenium. [1] [5]
Локатор, изобретённый без проверки приложенияОтклонитьПусть агент проверит настоящую страницу или запустит временный скрипт обнаружения, затем просматривает предложенный локатор. [1] [2]

Шаблон может скомпилироваться, но всё равно быть неправильным выбором. Таким образом, гейт проверяет как синтаксис, так и инженерное намерение.


Разместите правила так, чтобы агент мог их прочитать

Selenium рекомендует хранить конвенции проекта в AGENTS.md, CLAUDE.md или файле правил, используемый инструментом для программирования. [1] Версия и команды должны совпадать с фактическим репозиторием.

Компактная отправная точка может выглядеть так:

## Browser automation

- Use the Selenium version pinned by this repository.
- Consult https://www.selenium.dev/llms.txt and current Selenium documentation.
- If an API is absent from the current documentation or API reference, do not use it.
- Do not add third-party driver managers or hard-coded driver paths.
- Configure browsers through Options.
- Use By locators verified against the real DOM; do not use absolute XPath.
- Do not use fixed sleeps for synchronization. Wait for the required condition.
- Run the focused test and attach the exact exception and a screenshot when it fails.
- Always quit the driver in teardown.
- Never put учётные данные or personal production data in code, prompts, logs, or screenshots.

Это пример политики, а не сгенерированный фреймворк. Адаптируйте его под языковую связку, тест-раннер, браузеры и команды, которые действительно использует проект.


Ворота: от запроса к доказательствам слияния

1. Определить тестовый контракт

Перед тем как попросить агента написать код, уточните:

Ввод: Правила тестового объектива плюс репозитория. Выход: сценарий, который можно пересмотреть, с наблюдаемым ожидаемым результатом.

Если ожидаемый результат расплывчатый, сгенерированные утверждения тоже будут расплывчатыми.

2. Проверьте каждый незнакомый API по текущим источникам

Предоставьте агенту llms.txt Selenium, текущую документацию, ссылку на API и исполняемые примеры. Selenium прямо рекомендует рассматривать API, который не может быть найден в текущей документации или ссылке на API, как отсутствующий. [1] [2]

Рецензент должен проверить:

Не стоит полагаться на правдоподобное объяснение из модели как на доказательство.

3. Проверьте реальное приложение перед принятием локаторов

Агент, который не видит страницу, должен угадывать. Дайте ему доступ к безопасной тестовой среде или пусть он запускает временный скрипт обнаружения Selenium. Проверьте кандидатные элементы до написания финального теста. [1] [2]

Полезный обзор локатора спрашивает:

Сессия браузера не должна раскрывать производственные учетные данные, данные клиента, токены сессии или приватные идентификаторы.

4. Предпочитайте условие вместо задержки

Фиксированный сон определяет, сколько времени требуется приложению. Явное ожидание описывает состояние, необходимое тесту. Selenium также предупреждает против смешивания неявных и явных ожиданий, поскольку полученный тайм-аут может быть непредсказуемым. [4]

Следующий пример на Python использует текущие API Selenium. Значения URL и data-testid являются иллюстративными и должны быть проверены с реальным приложением.

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC


driver = webdriver.Chrome()
try:
    driver.get("https://app.example.test/login")

    wait = WebDriverWait(driver, 10)
    submit = wait.until(
        EC.element_to_be_clickable(
            (By.CSS_SELECTOR, "[data-testid='login-submit']")
        )
    )

    assert submit.is_displayed()
finally:
    driver.quit()

Важный вопрос не в том, является ли десять секунд универсально правильными. Вопрос в том, отражает ли выбранное условие видимое для пользователя состояние, которое требует сценарий, и есть ли у проекта обоснованная политика тайм-аута.

5. Проведите один сфокусированный тест и сохраняйте доказательства отказа

Рабочий процесс Selenium рекомендует запускать новый тест самостоятельно перед запуском пакета. [1] Если он не работает, дайте агенту точное исключение, а не сводку, например «тест провалился». Скриншот в момент отказа может показать наложение, баннер cookie, неожиданный диалог или перехваченный клик. [1] [2]

Рекомендуемые выходы затвора — это артефакты, определённые командой, такие как:

Эти названия и форматы не обязательны Selenium. Выбирайте форматы, которые ваша система CI сможет сохранить и которые рецензенты смогут прочитать.

6. Повторяйте, чтобы искать гонки, а не доказывать совершенство

Selenium советует провести сфокусированный тест несколько раз, прежде чем доверять ему; один проход не означает, что тест без гонок. [1] Количество повторений должно устанавливаться командой в зависимости от риска и времени выполнения.

Рекорд:

Не требуйте одинаковых полностраничных DOM-хешей. Современные страницы могут содержать временные метки, рандомизированные идентификаторы, аналитическую разметку и асинхронный контент. Сравните бизнес-утверждение и выбранные стабильные доказательства.

Несколько успешных забегов повышают уверенность, но никогда не доказывают, что тест проходит без ошибок.

7. Проанализируйте различия и примите человеческое решение

Последний рецензент проверяет как код, так и доказательства:

Только человек-владелец меняет решение с нуждается в работе на одобрено для слияния.


Архитектура и поток данных

СценаВходПервичная проверкаРезультаты
Тестовый контрактТребования, риски, окружающая средаОжидаемое поведение наблюдаемоДоказательства сценария и принятия
Контекст агентаКонтракт, файл правил, актуальная документацияВерсии и конвенции явно прописаныКод кандидата
Обнаружение браузераБезопасная среда тестированияЛокаторы совпадают с настоящим DOMРассмотренный набор локаторов
Сфокусированное исполнениеТест кандидатовОдин из сценариев основан на реальных утвержденияхСтатус выхода и артефакты неудачи
Проверка повторяемостиСфокусированное командованиеФиксируются периодические отказыКраткое содержание бега
Человеческий обзорРазличия плюс доказательстваТехнические, безопасные и намерения продуктаРешение о слиянии
CIУтверждённый тестЭлементы качества репозиторияАудируемый результат

Проваленный этап возвращает доказательства автору. Он не запускает автоматическое увеличение тайм-аута или вставку сна.


Положительные, отрицательные и регрессионные проверки для шлюза

Проверьте сам гейт. Полезные сценарии включают:

Положительные проверки

Отрицательные проверки

Проверки повторяемости

Используйте синтетические удостоверения и непроизводственные данные для этих тестов.


Границы безопасности и тестовых данных

Подсказки ИИ и артефакты браузера могут утекать не только исходный код. Примените следующие элементы:

Секретное сканирование по регулярным выражениям полезно, но недостаточно. Человеческий контроль всё ещё необходим, поскольку чувствительные бизнес-данные могут не походить на токен.


WebDriver BiDi: проверьте поддержку, не предполагайте её

WebDriver BiDi — это двунаправленный протокол W3C, предназначенный как кроссбраузерная замена протоколу CDP. Документация Selenium охватывает журналирование, сетевые и скриптовые функции и отмечает, что поддержка CDP является временной на период внедрения BiDi.[5]

Это направление не гарантирует, что все желаемые функции доступны в каждом браузере и языковой связке сегодня. Перед утверждением кода, зависящего от BiDi:

  1. проверьте актуальную документацию по Selenium для получения точной характеристики;
  2. проверьте версии Selenium и браузера проекта;
  3. запустить поведение на каждом браузере, заявленном тестом;
  4. Держите задокументированный запасной вариант или сузите поддерживаемый диапазон.

Врата должны отвергать неподтверждённую уверенность, а не эксперименты.


Определение готовности

Тест на Selenium, сгенерированный ИИ, готов к слиянию, когда:


Заключение

Безопасный способ использовать ИИ‑агент по написанию кода с Selenium — не доверять ему и не отклонять его по умолчанию. Дайте ему актуальную документацию, чёткие правила репозитория и доступ к безопасному реальному браузеру. Затем потребуйте целенаправленное выполнение, доказательства сбоев, наблюдения повторяемости и человеческое решение о слиянии.

Этот гейт фиксирует устаревшие шаблоны, которые выглядят правдоподобными, компилируются локально и позже становятся нестабильным техническим долгом. Что более важно, он сохраняет ответственность там, где ей место: ИИ предлагает код; команда проверяет поведение и принимает решение о выпуске.


Источники

  1. Selenium documentation — Using ИИ coding agents with Selenium
  2. Selenium blog — Your Agent Learned Selenium From My Old Blog Posts
  3. Selenium documentation — Selenium Manager
  4. Selenium documentation — Waiting Strategies
  5. Документация Selenium — WebDriver BiDi