Testare Software

Parcurs: Începător · lecția 22 din 35

ÎncepătorNoțiuni de bază4 min de cititPublicat 12 noiembrie 2026

Ce este un raport de bug? Cum scrii unul excelent

Raportul de bug este modul în care o problemă găsită de tine devine o problemă reparată de altcineva. Iată ce să incluzi, un șablon pe care îl poți refolosi și obiceiurile care duc la reparații mai rapide.

Pe această pagină

De reținut

  • Un raport de bug descrie o problemă atât de clar încât altcineva o poate reproduce, îi poate înțelege impactul și o poate repara.
  • Esența e simplă: pașii de reproducere, rezultatul așteptat, rezultatul obținut, plus mediul și dovezile.
  • Rapoartele excelente sunt precise, minimale și neutre. Un bug pe raport, fapte, nu vinovați.

Ce este un raport de bug

Un raport de bug (numit și raport de defect sau issue) înregistrează o problemă pe care ai găsit-o. De obicei se scrie într-o unealtă de urmărire precum Jira, Azure DevOps, GitHub Issues sau Bugzilla.

Are trei cititori:

  • Programatorul, care trebuie să o reproducă și să găsească cauza.
  • Product ownerul sau liderul, care decide cât de urgent se repară.
  • Tu, mai târziu, când trebuie să o retestezi după reparare.

Un bug care nu poate fi reprodus, de obicei, nu poate fi reparat. De aceea raportul e la fel de important ca descoperirea.

Ce conține un raport de bug

CâmpCe scrii
TitluCe e greșit, unde și în ce condiție. Scurt și precis.
MediuVersiunea sau build-ul aplicației, browserul sau dispozitivul, sistemul de operare, mediul de test, rolul utilizatorului.
PrecondițiiCe e nevoie înainte de pași: tip de cont, date, setări.
Pași de reproducereNumerotați, minimi, exacți. Include datele folosite.
Rezultat așteptatCe ar trebui să se întâmple, ideal cu link spre cerință.
Rezultat obținutCe s-a întâmplat de fapt. Mesajele de eroare exacte, copiate, nu reformulate.
FrecvențăDe fiecare dată sau în 3 din 10 încercări?
SeveritateCât de grav e impactul. Prioritatea e stabilită adesea mai târziu, de product owner.
AtașamenteCaptură de ecran, video, log-uri, cereri de rețea (fișier HAR), erori din consolă.

Un raport slab și unul excelent

Exemplu realAcelași bug, raportat de două ori

Slab:

Titlu: Checkout-ul e stricat!!!

Checkout-ul nu merge. Vă rog reparați urgent.

Programatorul trebuie să ghicească totul: ce pagină, ce utilizator, ce metodă de plată, ce înseamnă „nu merge”.

Excelent:

Titlu: Checkout: butonul „Plătește” nu face nimic când e aplicat un cod de reducere (Safari 17)

Mediu: Build 2.14.0, staging, Safari 17.4 pe macOS 14. Client autentificat.

Pași:

  1. Adaugă orice produs în coș.
  2. Aplică codul de reducere PRIMAVARA10.
  3. Mergi la checkout și apasă Plătește.

Așteptat: Se deschide formularul de plată.

Obținut: Nu se întâmplă nimic. Consola afișează TypeError: discount.total is undefined.

Frecvență: 5 din 5 încercări. Merge în Chrome 124. Merge în Safari fără cod de reducere.

Atașamente: înregistrare video a ecranului, captură a consolei.

Lecția: al doilea raport restrânge deja problema la Safari plus cod de reducere, înainte ca un programator să-l deschidă. Asta înseamnă să izolezi un bug și economisește ore întregi.

Obiceiuri care duc la reparații

  1. Reprodu-l întâi. Mai încearcă o dată înainte să raportezi. Notează dacă apare de fiecare dată.
  2. Izolează-l. Schimbă câte un singur lucru: alt browser, alt utilizator, alte date. Fiecare diferență găsită restrânge cauza.
  3. Caută duplicate. Poate l-a raportat deja cineva. Adaugă detaliile tale acolo.
  4. Un bug pe raport. Două probleme într-un raport înseamnă că una e uitată când cealaltă se repară.
  5. Pași minimi. Scoate orice pas care nu e necesar ca să apară bug-ul.
  6. Copiază, nu reformula. Textul exact al erorii, valorile exacte, URL-urile exacte.
  7. Rămâi neutru. Descrie comportamentul produsului, nu persoana care l-a construit.

Așa da

Să scrii titluri ca pe o căutare: „Factura PDF: TVA-ul apare 0 la comenzile cu livrare gratuită.” Oricine îl găsește mai târziu.

Așa nu

Să scrii titluri ca „Bug la facturi”, „Nu merge” sau „URGENT!!!”. Ascund problema și dau un ton greșit.

După ce l-ai raportat

Un raport de bug are un ciclu de viață. Stări des întâlnite: Nou → Asignat → Reparat → De retestat → Închis, plus Redeschis dacă reparația nu funcționează.

Când vine reparația, rulează din nou pașii inițiali ca să confirmi că problema a dispărut. Apoi verifică zona din jur, în caz că reparația a stricat altceva.

Verifică-te

Ai descoperit că pagina de căutare nu afișează niciun rezultat pentru cuvântul „ciocolată”, dar merge pentru „ciocolata”. Care ar fi un titlu bun pentru raport?

Arată răspunsul

Ceva de genul: „Căutare: niciun rezultat pentru termeni cu diacritice (ex. «ciocolată»); «ciocolata» funcționează.” Spune unde e bug-ul, ce îl declanșează și dă un exemplu, așa că oricine înțelege problema doar din titlu.