Правила

Правило — сердце продукта. Это маленькая проверка, которая ищет одну конкретную проблему на странице и выполняется прямо в браузере, без обращения к модели. Из-за этого проверки быстрые и ничего не стоят, сколько бы раз вы их ни запускали. Ниже — откуда берутся правила, что они умеют и что значит «подтвердить» правило.

Что такое правило

Небольшой набор условий на языке JavaScript — на нём пишут программы для браузера. Правило открывает страницу, смотрит на её элементы и решает: всё в порядке или есть проблема. Если проблем несколько, у каждой будет своё сообщение, указание на виноватый элемент и важность: подсказка, предупреждение или ошибка.

Проверка умеет смотреть на текст элементов, их размеры, расположение, количество и контраст — то есть на то, что видит человек своими глазами. Например: «кнопка входа должна быть видна и не меньше 40 пикселей в высоту» или «на странице оплаты должен быть ровно один заголовок с суммой».

Откуда берутся правила

  • Из замечания — основной путь. Вы описываете проблему словами, агент пишет правило и сам решает, на какие страницы его распространить.
  • Руками — любое правило можно открыть и поправить: это обычный файл в папке проекта. Пригодится, когда нужно изменить порог, например «не меньше 48 пикселей» вместо 40.
  • С помощью агента — если правило работает не так, как хотелось, его можно попросить исправить словами, не трогая код.

Где работает правило

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

Панель в браузере показывает на открытой странице только те правила, которые к ней подходят, — поэтому список всегда короткий и по делу.

Проверка и подтверждение

Кнопка Проверка страницы в панели прогоняет все подходящие правила и показывает результат по каждому: прошло или нашлась проблема. Результаты сохраняются — это первое доказательство, что правило работает на настоящем сайте, а не только в голове агента.

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

Состояния правила

  • Подтверждено — проверка работает, ей можно доверять и включать в тесты.
  • Не подтверждено — правило ещё ни разу не запускалось. В тестах не участвует.
  • Исправлено агентом — нужна проверка — правило сломалось и агент сам его починил. Пометка держится, пока вы не посмотрите на результат: чужая правка без вашего глаза всегда рискованна.
  • Отключено — правило есть, но не выполняется. Так удобно убирать устаревшие проверки, не теряя их текст.

Копилка знаний

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

Ограничения

  • Пара секунд на проверку — правило должно укладываться в это время. Долгая проверка тормозит весь запуск, поэтому тяжёлые задачи лучше разбивать на несколько простых.
  • Предел на весь набор правил — примерно 100 килобайт кода на проект. Всё, что не влезло, пропускается с пометкой: это видно в результатах. Обычно упираются в предел, когда копируют огромные проверки целиком, — здесь помогает вынести общее в одно правило.

Дальше: как записать сценарий работы с интерфейсом — в разделе Действия.

← Оглавление документации