← Усі статті
QA · 8 хв читання

Баг-репорти, які люблять розробники: шаблон і реальні приклади

Хороший баг-репорт виправляють швидше. Ось наш шаблон, приклад поганого й хорошого репорту і те, як ми визначаємо серйозність і пріоритет.

Баг, який неможливо відтворити, не виправляють. Баг-репорт, на розуміння якого розробник витрачає двадцять хвилин, відкладають. Якість баг-репортів напряму впливає на швидкість команди, тому ми вважаємо їх написання ключовою навичкою QA, а не бюрократією.

Анатомія хорошого репорту

ПолеЩо писати
ЗаголовокЩо зламано, де і за якої умови. Коротко й так, щоб легко знайти пошуком
ОточенняЗбірка/версія, URL, пристрій, ОС, браузер, тип акаунта
ПередумовиДані чи стан, потрібні до кроку 1
Кроки відтворенняНумеровані, мінімальні, одна дія на крок
Очікуваний результатЩо має відбутися, бажано з посиланням на вимогу
Фактичний результатЩо відбувається натомість, включно з текстом помилки
ДоказиСкриншот, відео, логи, мережевий запит (HAR), помилки в консолі
Серйозність / ПріоритетВплив на продукт / терміновість виправлення
ЧастотаЗавжди, іноді (3 з 10), один раз

Поганий і хороший

Поганий репорт:

Оформлення замовлення не працює. Я спробував щось купити, і нічого не вийшло. Виправте терміново!!!

Той самий баг, описаний добре:

Заголовок: Оформлення – кнопка «Оплатити» залишається неактивною після застосування промокоду в мобільному Safari

Оточення: staging build 1.4.2 (#1287), iPhone 13, iOS 17.5, Safari
Акаунт: зареєстрований користувач test.buyer+12@…, кошик із 2 товарів ($64.00)

Кроки:
1. Відкрити /cart
2. Ввести промокод SPRING10 і натиснути «Застосувати»
3. Натиснути «Оформити» й заповнити коректну адресу
4. Обрати «Картка» як спосіб оплати

Очікувано: кнопка «Оплатити $57.60» активна
Фактично: кнопка неактивна; в консолі
        TypeError: total.toFixed is not a function (checkout.js:214)

Частота: 5/5 в iOS Safari; не відтворюється в Chrome на десктопі
Докази: video.mp4, console.log, HAR-файл додано
Серйозність: Critical (користувачі не можуть оплатити)  Пріоритет: High

Другу версію можна виправити без жодного уточнювального питання. Помилка в консолі навіть вказує розробнику на рядок коду.

Серйозність і пріоритет

Серйозність описує вплив дефекту на систему. Пріоритет — як швидко його треба виправити. Зазвичай вони пов'язані, але не завжди, і ця різниця важлива при плануванні.

Пріоритет →Серйозність →Низька серйозність · Високий пріоритетПомилка в назві бренду на головній;Неправильний формат ціни в рекламіВисока серйозність · Високий пріоритетКористувачі не можуть оплатити;Втрата даних, вразливість
Серйозність і пріоритет — різні осі. Приклади з реальних проєктів.

Наш чекліст перед натисканням «Створити»

  1. Відтворено щонайменше двічі, бажано в чистій сесії
  2. Перевірено, чи немає дубліката
  3. Кроки мінімальні: прибрано все, що не потрібне для відтворення
  4. Один баг — один репорт
  5. Заголовок зрозумілий без відкриття тікета
  6. Докази додано, чутливі дані приховано
  7. Без емоцій і звинувачень, лише факти

Після репорту

Коли баг виправлено, QA перевіряє виправлення в тому самому оточенні й робить коротку регресію довкола. Для багів, що повторюються, ми проводимо аналіз першопричин: чому це сталося і який тест, рев'ю чи перевірка зловили б це раніше? Саме це питання допомагає командам не бачити той самий тип бага двічі.