Экран — это то, на что смотрит продукт: страница в том виде, в каком вы её увидели. Замечание — то, что вы про неё думаете, обычными словами. Вместе они образуют начало всей работы: из замечания агент делает проверку, которая дальше работает сама. Ниже — как снимать экраны, писать замечания и запускать разбор. И сразу оговорка: экран — не то же самое, что снимок визуальной проверки, этому различию посвящён отдельный раздел ниже.
Что такое экран
Снимок видимой области страницы плюс её описание: адрес, заголовок, размер окна и структура — заголовки, кнопки, поля и их количество. Всё это снимается одной кнопкой из панели и сохраняется сразу же: промежуточного шага «проверить и сохранить» нет, потому что потерять несохранённый снимок гораздо неприятнее, чем убрать лишний.
Картинка хранится в базе продукта, а не отдельным файлом в папке проекта. Поэтому снимков можно наделать сколько угодно, и они не забьют историю правок ваших файлов.
Не путайте экран со снимком визуальной проверки — он описан ниже и в разделе Визуальное тестирование.
Экран и снимок визуальной проверки — не одно и то же
Они выглядят похоже — и то и другое картинка со страницы, — но живут разными задачами. Экран нужен для замечаний и правил: у него есть ваш текст, тип экрана и разбор агентом. Он лежит в галерее проекта и служит материалом для обучения.
Снимок визуальной проверки — другое дело. Его вид (часть страницы, вся страница, компонент, элемент или текстовый снимок) заранее объявляет сам шаг теста, он привязан к этому шагу и сравнивается с эталоном во время сборки. Замечаний у него не бывает: его дело — показать, изменилась ли страница.
Отсюда простое правило: экранов может быть сколько угодно, и в сравнении они не участвуют; снимков ровно столько, сколько объявлено шагами теста. Подробнее — в разделе Визуальное тестирование.
Галерея экранов
Все снимки проекта лежат на вкладке «Экраны». Там есть поиск, отбор по типу экрана и кнопка «Показать ещё» — список длинный, и листать его целиком обычно не нужно. В карточке экрана видно сам снимок, откуда он пришёл, его тип и замечания.
Откуда пришёл снимок — важная пометка: снят вручную, «через действие» (получен при прогоне записанного сценария) или «из запуска» (оставлен шагом теста). Так вы всегда знаете, смотрите вы на свою тренировочную страницу или на доказательство из последнего запуска.
Замечания
Замечание — обычный текст: «кнопка не видна на тёмном фоне», «после отправки формы непонятно, что произошло». Писать можно из панели сразу после съёмки или позже из карточки экрана в приложении. Замечания лежат файлами в папке проекта — то есть попадают в историю правок вместе с правилами и тестами.
Сами по себе замечания не разбираются: продукт ничего не отправляет агенту, пока вы не попросите. Это сделано, чтобы не тратить деньги на разборы, которые вам не нужны прямо сейчас.
Кнопка «Вызвать агента»
Когда разбор нужен, нажмите «Вызвать агента». В поле чата подставится готовый отчёт по экрану: ваши замечания дословно, ссылка на снимок, накопленные знания о проекте, список правил и типов экранов. Отправляется только то, что вы допишете ниже, — то есть само нажатие ничего не тратит.
Допишите просьбу и отправьте. В ответ модель вернёт три вещи: правило — проверку, которая ищет эту проблему дальше без модели; прирост знаний — что она поняла про ваш интерфейс, эти записи пригодятся в следующих разборах; и тип экрана — к какой группе страниц относится снятая.
- В очереди — разбор ждёт своей очереди: одновременно идёт только один, чтобы работа агента не смешивалась.
- Разбирается — агент читает отчёт и готовит ответ.
- Готово — правило, знания и тип экрана записаны в проект.
- Ошибка — разобрать не получилось: агент недоступен или ответ пришёл в неверном виде. Ответ сохраняется целиком, и рядом есть кнопка повтора. Если сервер перезапустился посреди разбора, замечание вернётся в очередь само.
Один разбор — один ответ. Сообщения, которые вы печатаете в чате после этого, продукт заново не разбирает: чтобы получить новое правило, отправьте отчёт ещё раз.
Типы экранов
Тип экрана — это название группы страниц с образцом адреса. Например, тип «вход» с образцом /login соберёт все страницы входа, а проверка, привязанная к этому типу, будет работать только на них. Типы назначает агент во время разбора, но можно задать их и руками — в проекте им соответствует файл screen-types.yml.
Удаление и чистота
Экран удаляется вместе со снимком и замечаниями — лишние тренировочные страницы разумно убирать, чтобы список оставался обозримым. На уже выпущенные правила удаление не влияет. Эталоны и снимки визуальных сборок оно тоже не трогает — это отдельные хранилища.
Панель дополнения в кадр не попадает никогда — об этом позаботились отдельно, чтобы снимки были честными. И сразу оговорка про ссылки: ссылка на снимок открывается без входа в продукт, так устроены запросы к модели — она скачивает картинку по обычной ссылке. Поэтому сервер Агента тестирования лучше держать в закрытом контуре, куда нет доступа со стороны.
Дальше: из чего состоит правило и как его подтвердить — в разделе Правила.