Поиск элементов в BAS: селекторы, которые не ломаются

Каждое действие BAS, которое касается страницы - клик, ввод, извлечение - сначала должно найти элемент. Сделаете селектор правильно - бот работает месяцами; ошибётесь - он сломается при следующем редизайне сайта. Это важнейший навык надёжной браузерной автоматизации.

Как работает поиск элементов в BAS

Когда вы записываете действие, BAS фиксирует селектор, указывающий на элемент, с которым вы взаимодействовали. При повторе он запрашивает живой DOM этим селектором и действует на совпадение. Запись удобна, но часто выбирает хрупкие селекторы - длинные цепочки автогенерируемых классов или позиции nth-child, которые легко меняются.

Решение - относиться к записанному селектору как к черновику и дорабатывать его руками.

CSS-селекторы: ваш выбор по умолчанию

CSS-селекторы покрывают подавляющее большинство случаев и работают быстрее всего. Приоритет того, на что опираться:

1. id - #login-button. Уникален и стабилен, когда есть.
2. name - input[name="email"]. Часто встречается и надёжен на формах.
3. Атрибуты data-* - [data-testid="submit"]. Разработчики часто добавляют их специально как стабильные зацепки.
4. Семантические комбинации класса/атрибута - button.primary[type="submit"].

Избегайте привязки к классам вроде css-1a2b3c - их генерируют сборщики, и они меняются с каждым релизом.

XPath: когда CSS не хватает

XPath мощнее, но медленнее и многословнее. Используйте его для двух вещей, которые CSS не умеет:

• Поиск по видимому тексту: //button[contains(text(),"Войти")] - незаменимо, когда у кнопок нет стабильных атрибутов.
• Движение относительно другого элемента: найти подпись (label), затем её соседний input.

Если цель выражается через CSS - предпочитайте CSS. Переходите на XPath только ради поиска по тексту и реляционных запросов.

Селекторы, которые переживают изменения

• Привязывайтесь к смыслу, а не к вёрстке. [name="password"] описывает, что это за поле; div:nth-child(3) > input - где оно случайно стоит сегодня.
• Делайте короче. Каждый лишний шаг в цепочке - ещё одна точка, которая может измениться.
• Один сильный атрибут лучше длинного хрупкого пути.
• Проверяйте после перезагрузки. Перезапустите после жёсткого обновления; хороший селектор совпадает каждый раз.

Дело не только в выборе - ещё и в таймингах

Правильный селектор всё равно упадёт, если элемент ещё не отрисовался. Страницы грузятся асинхронно, поэтому сочетайте выбор с шагом ожидания элемента перед действием. Большинство ошибок «селектор не найден» - это на самом деле ошибки таймингов: элемента просто ещё не было.

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