Woordenlijst

Waarom reproductiestappen bepalen of een bug wordt opgelost

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •6 min leestijd
Waarom reproductiestappen bepalen of een bug wordt opgelostWaarom reproductiestappen bepalen of een bug wordt opgelost

TL;DR, kort antwoord

6 min leestijd

Reproductiestappen zijn de genummerde acties, de beginsituatie en de invoer waarmee een tweede persoon dezelfde bug kan oproepen die de eerste vond. Een volledige set noemt de voorwaarden, de exacte klikken of invoer op volgorde, het verwachte resultaat, het werkelijke resultaat en de omgeving. Sla er één over en een engineer kan de bug niet reproduceren of reproduceert een andere, en daarom is "works on my machine" een ontbrekende voorwaarde en geen mysterie.

Wat zijn reproductiestappen in een bugrapport?

Een bugrapport verdient het label reproduceerbaar als de reproductiestappen de exacte genummerde acties, de beginsituatie en de invoer noemen die nodig zijn om de fout opnieuw op te roepen. Iedereen die de lijst leest, niet alleen degene die de bug vond, moet hem kunnen volgen en bij dezelfde fout uitkomen. Schrijf de stappen als een kort script dat iemand anders kan uitvoeren, niet als samenvatting van wat er gebeurde, of voeg een session replay toe zodat het script zichzelf uit de opname schrijft.

Wat bevat een volledig onderdeel met reproductiestappen?

Een volledig onderdeel noemt vijf dingen: de voorwaarden, de genummerde acties, het verwachte resultaat, het werkelijke resultaat en de omgeving. Ontbreekt er één, dan wordt een reproduceerbare bug een gok, want een engineer zonder beginsituatie moet die eerst reconstrueren voordat hij de stappen zelfs maar kan proberen. Dat detail bepaalt ook ernst versus prioriteit, want wie zonder volledige reproductie scoort, gokt naar zowel de schade als de urgentie.

VeldWelke vraag het beantwoordtVoorbeeld
VoorwaardenWelke situatie moet er vóór stap 1 zijnIngelogd, winkelwagen met 2 artikelen, kortingscode toegepast
Genummerde stappenWat aanklikken, typen of versturen, op volgorde1. Open de checkout 2. Klik op "Cadeaukaart toepassen" 3. Voer een code van 20 cijfers in
Verwacht resultaatWat er hoort te gebeurenFoutmelding: "Ongeldige code"
Werkelijk resultaatWat er in plaats daarvan gebeurtPagina wordt leeg, geen fout getoond
OmgevingWaar het gebeurtChrome 128, macOS 15, staging

Iemand klikt aan een bureau door een webapp, het soort sessie dat een bugrapport stap voor stap moet beschrijven.

Waarom zijn voorwaarden belangrijk vóór de genummerde stappen?

Voorwaarden zijn belangrijk omdat dezelfde reeks klikken verschillende resultaten geeft, afhankelijk van de situatie waarin de gebruiker begon. "Klik op checkout" gedraagt zich anders met een lege winkelwagen dan met een kortingscode die al is toegepast, dus een lijst stappen zonder voorwaarden geeft een engineer de acties, maar niet de startlijn. Noem vóór stap één het type account, de data die al in het systeem staat en eerdere acties in dezelfde sessie.

Hoe schrijf je verwacht versus werkelijk gedrag?

Verwacht en werkelijk gedrag horen op aparte regels, elk met één concrete uitkomst in plaats van een gevoel over de bug. Schrijf het verwachte resultaat als wat de interface hoort te tonen, en het werkelijke resultaat als precies wat er in plaats daarvan verscheen, inclusief fouttekst, een leeg scherm of een verkeerde waarde. "De pagina ziet er kapot uit" reproduceert niets; "verwachtte een melding 'Ongeldige code', kreeg een lege witte pagina zonder console-output" geeft de engineer een specifiek doel om te matchen.

Welke omgevingsdetails horen in een bugrapport?

Omgevingsdetails dekken de browser en versie, het besturingssysteem, de schermgrootte, de netwerkomstandigheden en of de bug in productie, staging of een lokale build gebeurde. Een layoutbug die samenhangt met hoe Safari flexbox afhandelt, of een timingbug die samenhangt met een trage verbinding, verdwijnt zodra iemand test op een andere opzet. De regel over de omgeving is dus wat "ik kan dit niet reproduceren" verandert in "ik heb de verkeerde browser getest."

Twee developers vergelijken notities bij een laptop, het soort controle naast elkaar dat een afwijkende omgeving vangt.

Waarom gebeurt "works on my machine"?

"Works on my machine" gebeurt als de melder en de engineer ongemerkt met andere voorwaarden of omgevingen werken, niet omdat de bug nep is. Een feature flag die voor het ene account aanstaat en voor het andere uit, een verouderde cache, een andere schermbreedte of een browserextensie die een script blokkeert: ze reproduceren de fout allemaal voor de ene persoon en verbergen hem voor de volgende. Behandel de uitspraak als een ontbrekend veld in het rapport en vul de omgeving en voorwaarden aan in plaats van het ticket te sluiten. Bij een lange flow helpt het om hem in te korten tot een minimaal reproduceerbaar voorbeeld dat ook op een tweede machine faalt; zo zie je welke voorwaarde echt het verschil maakt.

Dezelfde bug, een andere machine
Feature flagAan voor het ene account, uit voor het andere
Verouderde cacheServeert een oude versie aan één persoon
SchermbreedteEen andere viewport toont een andere layout
BrowserextensieBlokkeert een script voordat het draait
Elk van deze kan verschillen tussen de melder en de engineer, en dan verdwijnt dezelfde bug voor een van beiden.

Hoe verkort session replay het schrijven van reproductiestappen?

Session replay verkort het uitschrijven omdat de opname al elke klik, elke invoer en elke paginastatus bevat die een handmatig rapport met de hand zou moeten beschrijven. Flowsery voegt de replay en de reproductiestappen automatisch toe aan elk issue en bugrapport dat in Slack, Linear of Jira binnenkomt, zodat een engineer de exacte reeks bekijkt in plaats van te vertrouwen op wat een gebruiker zich herinnert te hebben aangeklikt. Rage clicks en dead clicks markeren het moment waarop de gebruiker tegen de fout aanliep, wat het gokwerk wegneemt over waar in de flow je moet beginnen met zoeken, en @flowsery taggen in dezelfde Slack-thread opent een draft pull request zodra de oplossing duidelijk is.

Een rapport schrijven dat iemand anders kan reproduceren
1
Noem de voorwaarden. Accountstatus, bestaande data en eerdere acties in de sessie.
2
Nummer elke actie. Eén klik, tik of invoer per regel, in de volgorde waarin ze werden uitgevoerd.
3
Scheid verwacht van werkelijk. Twee concrete regels, geen alinea over hoe het voelde.
4
Leg de omgeving vast. Browser, besturingssysteem, schermgrootte en of het productie of staging was.
Vier velden die van een bugbeschrijving reproductiestappen maken.

Veelgestelde vragen

Wat maakt reproductiestappen goed in plaats van vaag?

Goede reproductiestappen zijn genummerd, beginnen bij een genoemde voorwaarde en eindigen met een genoemd verwacht resultaat naast het werkelijke resultaat. Een vaag rapport beschrijft een gevoel ("de checkout is kapot"); een goed rapport noemt vijf klikken, wat er had moeten verschijnen en wat er in plaats daarvan verscheen.

Wat is het verschil tussen reproductiestappen en een bugbeschrijving?

Een bugbeschrijving legt in proza uit wat er misging, terwijl reproductiestappen een script zijn dat iemand anders kan uitvoeren om dezelfde fout te zien. Een rapport kan een duidelijke beschrijving hebben en toch niet te reproduceren zijn als het de genummerde acties of de beginsituatie overslaat.

Waarom kan een engineer een bug die een klant meldt niet reproduceren?

Een engineer kan een gemelde bug meestal niet reproduceren omdat het rapport een voorwaarde of een omgevingsdetail mist, zoals een accountstatus, browserversie of feature flag die tussen de twee opzetten verschilt. De bug is echt; het rapport is onvolledig.

Wat hoort er in het onderdeel over de omgeving van een bugrapport?

Het onderdeel over de omgeving hoort de browser en versie, het besturingssysteem, de schermgrootte, de netwerkomstandigheden en het gegeven of de bug in productie, staging of lokaal optrad te noemen. Elk daarvan kan bepalen of een bug überhaupt verschijnt.

Hoeveel stappen hoort een reproductie te hebben?

Een reproductie hoort evenveel genummerde stappen te hebben als er losse acties waren die de gebruiker vóór de fout uitvoerde, niet meer en niet minder. Twee acties in één stap samenvoegen, of de lijst aanvullen met stappen die de uitkomst niet beïnvloeden, maakt het rapport moeilijker te volgen, niet makkelijker.

Vervangt session replay uitgeschreven reproductiestappen?

Session replay maakt het overbodig om de genummerde acties met de hand uit te schrijven, want de opname toont de exacte klikken, invoer en paginastatussen op volgorde. De omgeving en voorwaarden worden ook automatisch met de replay meegestuurd, zodat de engineer één issue opent in plaats van de melder om ontbrekende details te vragen.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Waarom telt "de pagina ziet er kapot uit" niet als bugrapport?

"De pagina ziet er kapot uit" beschrijft een gevoel, geen uitkomst, dus het geeft een engineer niets om tegen te matchen. Een rapport heeft twee aparte regels nodig: wat de interface hoorde te tonen, en precies wat er in plaats daarvan verscheen, inclusief fouttekst of een leeg scherm. Vergelijk het met "verwachtte een melding 'Ongeldige code', kreeg een lege witte pagina zonder console-output", wat direct aanwijst wat je moet controleren.

Hoe beïnvloeden reproductiestappen ernst en prioriteit?

Wie zonder volledige reproductiestappen scoort, moet gokken naar zowel de schade die een bug aanricht als hoe dringend hij opgelost moet worden. Voorwaarden, genummerde acties, verwacht resultaat, werkelijk resultaat en omgeving vertellen een triager samen wat er echt kapotgaat en voor wie. Sla een van die velden over en ernst en prioriteit worden schattingen in plaats van beslissingen.

Wat voegen rage clicks en dead clicks toe aan een bugrapport?

Rage clicks en dead clicks markeren het exacte moment waarop een gebruiker in een session replay tegen de fout aanliep. Dat tijdstempel neemt het gokwerk weg over waar je in een opgenomen flow moet beginnen met zoeken naar de bug. Samen met de automatisch toegevoegde reproductiestappen springt een engineer direct naar de fout in plaats van door de hele sessie te scrollen.

Aan welke tools voegt Flowsery automatisch reproductiestappen toe?

Flowsery voegt de session replay en de reproductiestappen automatisch toe aan elk issue dat in Slack, Linear of Jira binnenkomt. Een engineer bekijkt dan de exacte reeks klikken en invoer in plaats van te vertrouwen op wat de melder zich herinnert. @flowsery taggen in dezelfde Slack-thread kan ook een draft pull request openen zodra de oplossing duidelijk is.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde begrippen

Het bugrapporttemplate dat reviewers niet afwijzenHet bugrapporttemplate dat reviewers niet afwijzen
Woordenlijst

Het bugrapporttemplate dat reviewers niet afwijzen

Een bugrapporttemplate noemt elk veld dat een reviewer verwacht, van stappen om te reproduceren tot ernst, zodat onvolledige tickets worden afgewezen voordat een engineer ernaar kijkt.

•7 min leestijd
Wat zeven leveranciers publiceren over de bewaartermijn van session replay-dataWat zeven leveranciers publiceren over de bewaartermijn van session replay-data
Woordenlijst

Wat zeven leveranciers publiceren over de bewaartermijn van session replay-data

Bewaartermijnen van session replay-data vergeleken op basis van de docs van FullStory, Hotjar, Clarity, LogRocket, PostHog, Sentry en Datadog, plus wat de AVG vereist.

•8 min leestijd
Waar de data vandaan komt bij session replay vs heatmapsWaar de data vandaan komt bij session replay vs heatmaps
Woordenlijst

Waar de data vandaan komt bij session replay vs heatmaps

Session replay vs heatmaps: één bezoek tegenover veel, en hoe Hotjar, Datadog, PostHog, Clarity en FullStory heatmaps bouwen uit opnames, of los ervan.

•7 min leestijd
Wat rrweb vastlegt en hoe de privacyopties werkenWat rrweb vastlegt en hoe de privacyopties werken
Woordenlijst

Wat rrweb vastlegt en hoe de privacyopties werken

Hoe rrweb een sessie vastlegt als DOM-snapshot plus mutaties, niet als video: de npm-pakketten, de MIT-licentie en privacyopties zoals maskAllInputs en blockClass.

•8 min leestijd
Zo werkt een samplingpercentage voor session replay in Sentry, PostHog en andere toolsZo werkt een samplingpercentage voor session replay in Sentry, PostHog en andere tools
Woordenlijst

Zo werkt een samplingpercentage voor session replay in Sentry, PostHog en andere tools

Een samplingpercentage voor session replay bepaalt welk deel van de bezoeken wordt opgenomen. Bekijk hoe Sentry, PostHog, LogRocket, Datadog en Clarity het documenteren.

•8 min leestijd
Wat AVG-compliance voor session replay echt van je vraagtWat AVG-compliance voor session replay echt van je vraagt
Woordenlijst

Wat AVG-compliance voor session replay echt van je vraagt

Een AVG-beoordeling van session replay draait om vier dingen: een rechtsgrond uit artikel 6, bijzondere persoonsgegevens uit artikel 9, toestemming onder artikel 5, lid 3, ePrivacy en een DPIA.

•9 min leestijd

Gerelateerde artikelen