Как писать проверки и сообщения об ошибках

Зачем это отдельный навык

Тестировщика оценивают не по количеству найденного, а по тому, насколько понятно он это описал. Ошибка, которую невозможно воспроизвести, будет закрыта как «не подтверждается», и ваша работа пропадёт.

Это тот навык, который проверяют на собеседовании в первую очередь: просят описать любую ошибку и смотрят, что получится.

Структура проверки

Название. Что именно проверяем, одной фразой. «Вход с верными данными», а не «Проверка входа номер 3».

Предусловия. Что должно быть до начала: пользователь зарегистрирован, в корзине два товара.

Шаги. Пронумерованные, конкретные. Не «зайти в настройки», а «нажать на аватар в правом верхнем углу, выбрать Настройки».

Ожидаемый результат. Что должно произойти. Один результат на одну проверку.

Главный критерий: проверку должен суметь выполнить человек, который видит систему впервые. Если для выполнения нужны ваши знания, проверка написана плохо.

Структура сообщения об ошибке

Заголовок. Суть в одной строке: что не работает, где, при каких условиях. По заголовку должно быть понятно, стоит ли открывать.

Плохо: «Ошибка в форме». Хорошо: «При оплате картой с истёкшим сроком форма зависает, деньги не списываются, сообщения нет».

Шаги воспроизведения. Пронумерованные, начиная с чистого состояния. Это самая важная часть.

Ожидаемый результат. Что должно было произойти.

Фактический результат. Что произошло на самом деле.

Окружение. Браузер, версия, устройство, учётная запись, время.

Приложения. Снимок экрана, запись, текст ошибки из консоли, идентификатор запроса.

Важность и срочность. Насколько это ломает работу и насколько срочно чинить. Это разные вещи: опечатка на главной странице некритична, но срочна, потому что видна всем.

Разбор плохих примеров

«Не работает регистрация» — непонятно, что именно: не приходит письмо, падает форма, не принимает пароль. Разработчик потратит полчаса на выяснение того, что вы знали.

«Иногда слетает корзина» — «иногда» бесполезно. Нужны условия: после какого действия, через сколько времени, в каком браузере.

«Кривой дизайн на телефоне» — оценка вместо факта. Нужно: на устройстве таком-то в браузере таком-то текст выходит за границы блока, снимок приложен.

Три ошибки в одном сообщении — их будут чинить и закрывать по частям, и в итоге потеряют. Одна проблема — одно сообщение.

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

Воспроизведение с первого раза. Если разработчик не смог повторить, дальше не пойдёт.

Указание, когда сломалось. «Работало в прошлой версии» сужает поиск в разы.

Минимальные шаги. Уберите всё лишнее: не десять действий, а три, которые достаточны.

Влияние на людей. «Затрагивает всех, кто платит картой» действует сильнее, чем «серьёзная ошибка».

Как потренироваться

Возьмите любой сервис, найдите пять проблем и опишите каждую по схеме выше. Дайте прочитать человеку, который этим сервисом не пользовался, и попросите повторить по вашим шагам.

Если у него получилось — вы умеете писать сообщения об ошибках. Это готовый материал для портфолио и лучший ответ на просьбу «покажите пример вашей работы».