W skrócie
6 min czytaniaKroki do odtworzenia to ponumerowane działania, stan początkowy i dane wejściowe, które pozwalają drugiej osobie wywołać ten sam błąd, na który trafiła pierwsza. Kompletny opis podaje warunki wstępne, dokładne kliknięcia lub wpisy w odpowiedniej kolejności, oczekiwany wynik, faktyczny wynik i środowisko. Bez któregokolwiek z tych elementów programista albo nie odtworzy błędu, albo odtworzy inny, dlatego "u mnie działa" oznacza brakujący warunek wstępny, a nie zagadkę.
Czym są kroki do odtworzenia w zgłoszeniu błędu?
Zgłoszenie błędu zasługuje na miano odtwarzalnego, gdy jego kroki do odtworzenia wymieniają dokładne, ponumerowane działania, stan początkowy i dane wejściowe potrzebne do ponownego wywołania awarii. Każda osoba czytająca tę listę, a nie tylko ta, która znalazła błąd, powinna móc przejść ją i trafić na ten sam problem. Pisz kroki jak krótki scenariusz do wykonania przez kogoś innego, a nie jak streszczenie zdarzeń, albo dołącz nagranie sesji, dzięki czemu scenariusz powstanie sam.
Co zawiera kompletna sekcja kroków do odtworzenia?
Kompletna sekcja podaje pięć rzeczy: warunki wstępne, ponumerowane działania, oczekiwany wynik, faktyczny wynik i środowisko. Brak któregokolwiek z nich zamienia odtwarzalny błąd w zgadywanie, bo programista bez stanu początkowego musi go najpierw odtworzyć, zanim w ogóle spróbuje wykonać kroki. Te same szczegóły decydują też o wadze i priorytecie, ponieważ osoba oceniająca zgłoszenie bez pełnego odtworzenia zgaduje zarówno skalę szkód, jak i pilność.
| Pole | Na co odpowiada | Przykład |
|---|---|---|
| Warunki wstępne | Jaki stan musi istnieć przed krokiem 1 | Zalogowany użytkownik, 2 produkty w koszyku, zastosowany kupon |
| Ponumerowane kroki | Co kliknąć, wpisać lub wysłać, w jakiej kolejności | 1. Otwórz płatność 2. Kliknij "Użyj karty podarunkowej" 3. Wpisz 20-cyfrowy kod |
| Oczekiwany wynik | Co powinno się stać | Komunikat o błędzie: "Nieprawidłowy kod" |
| Faktyczny wynik | Co dzieje się zamiast tego | Strona robi się pusta, bez komunikatu o błędzie |
| Środowisko | Gdzie to występuje | Chrome 128, macOS 15, staging |

Dlaczego warunki wstępne są ważne przed ponumerowanymi krokami?
Warunki wstępne są ważne, bo ta sama sekwencja kliknięć daje różne wyniki w zależności od stanu, w jakim zaczął użytkownik. "Kliknij płatność" działa inaczej przy pustym koszyku, a inaczej przy zastosowanym kuponie, więc lista kroków bez warunków wstępnych daje programiście działania, ale nie punkt startu. Przed krokiem pierwszym podaj typ konta, dane obecne już w systemie i wcześniejsze działania w tej samej sesji.
Jak opisać oczekiwane i faktyczne zachowanie?
Oczekiwane i faktyczne zachowanie powinny znaleźć się w osobnych wierszach, a każdy z nich powinien podawać jeden konkretny wynik, a nie odczucie na temat błędu. Oczekiwany wynik opisz jako to, co interfejs ma pokazać, a faktyczny jako dokładnie to, co pojawiło się zamiast tego, w tym treść błędu, pusty ekran lub błędną wartość. "Strona wygląda na zepsutą" niczego nie pozwala odtworzyć, natomiast "oczekiwano komunikatu 'Nieprawidłowy kod', pojawiła się pusta biała strona bez wpisów w konsoli" daje programiście konkretny punkt odniesienia.
Jakie dane o środowisku powinny znaleźć się w zgłoszeniu błędu?
Dane o środowisku obejmują przeglądarkę i jej wersję, system operacyjny, rozmiar ekranu, warunki sieciowe oraz informację, czy błąd wystąpił na produkcji, na stagingu, czy w lokalnej kompilacji. Błąd układu związany z obsługą flexboxa w Safari lub błąd czasowy związany z wolnym łączem znika, gdy ktoś testuje w innej konfiguracji, więc wiersz o środowisku zamienia "nie mogę tego odtworzyć" w "testowałem w złej przeglądarce".

Skąd bierze się "u mnie działa"?
"U mnie działa" pojawia się wtedy, gdy zgłaszający i programista po cichu pracują przy innych warunkach wstępnych lub w innych środowiskach, a nie wtedy, gdy błąd jest zmyślony. Flaga funkcji włączona dla jednego konta i wyłączona dla drugiego, nieaktualna pamięć podręczna, inna szerokość ekranu lub rozszerzenie przeglądarki blokujące skrypt sprawiają, że awaria występuje u jednej osoby, a u drugiej nie. Traktuj to zdanie jak brakujące pole w zgłoszeniu i uzupełnij środowisko oraz warunki wstępne, zamiast zamykać zgłoszenie. Przy długim procesie skrócenie go do minimalnego odtwarzalnego przykładu, który wciąż zawodzi na drugim komputerze, pozwala ustalić, który warunek wstępny naprawdę ma znaczenie.
Jak odtwarzanie sesji skraca pisanie kroków do odtworzenia?
Odtwarzanie sesji skraca opis, bo nagranie zawiera już każde kliknięcie, wpis i stan strony, które w ręcznym zgłoszeniu trzeba opisać samodzielnie. Flowsery automatycznie dołącza nagranie i kroki do odtworzenia do każdego problemu i zgłoszenia błędu, gdy trafia ono do Slacka, Linear lub Jira, więc programista ogląda dokładną sekwencję, zamiast polegać na pamięci użytkownika. Wściekłe kliknięcia i martwe kliknięcia oznaczają moment, w którym użytkownik trafił na awarię, co eliminuje zgadywanie, od którego miejsca zacząć, a oznaczenie @flowsery w tym samym wątku na Slacku otwiera roboczy pull request, gdy poprawka jest już jasna.
Najczęściej zadawane pytania
Co odróżnia dobre kroki do odtworzenia od ogólnikowych?
Dobre kroki są ponumerowane, zaczynają się od podanego warunku wstępnego i kończą oczekiwanym wynikiem obok faktycznego. Ogólnikowe zgłoszenie opisuje odczucie ("płatność jest zepsuta"), a dobre wymienia pięć kliknięć, to, co powinno się pojawić, i to, co pojawiło się zamiast tego.
Czym kroki do odtworzenia różnią się od opisu błędu?
Opis błędu wyjaśnia prozą, co poszło nie tak, a kroki do odtworzenia to scenariusz, który inna osoba może wykonać, by zobaczyć tę samą awarię. Zgłoszenie może mieć jasny opis, a mimo to być nieodtwarzalne, jeśli pomija ponumerowane działania lub stan początkowy.
Dlaczego programista nie może odtworzyć błędu zgłoszonego przez klienta?
Zwykle dlatego, że w zgłoszeniu brakuje warunku wstępnego lub informacji o środowisku, na przykład stanu konta, wersji przeglądarki lub flagi funkcji, które różnią obie konfiguracje. Błąd jest prawdziwy, ale zgłoszenie jest niekompletne.
Co powinna zawierać sekcja o środowisku w zgłoszeniu błędu?
Powinna podawać przeglądarkę i jej wersję, system operacyjny, rozmiar ekranu, warunki sieciowe oraz informację, czy błąd wystąpił na produkcji, na stagingu, czy lokalnie. Każdy z tych elementów może przesądzić o tym, czy błąd w ogóle się pojawi.
Ile kroków powinno mieć odtworzenie błędu?
Tyle ponumerowanych kroków, ile odrębnych działań użytkownik wykonał przed awarią, nie więcej i nie mniej. Łączenie dwóch działań w jeden krok lub dodawanie kroków bez wpływu na wynik utrudnia śledzenie zgłoszenia.
Czy odtwarzanie sesji zastępuje spisane kroki do odtworzenia?
Odtwarzanie sesji zwalnia z ręcznego spisywania ponumerowanych działań, bo nagranie pokazuje dokładne kliknięcia, wpisy i stany strony w odpowiedniej kolejności. Środowisko i warunki wstępne są dołączane automatycznie wraz z nagraniem, więc programista otwiera jedno zgłoszenie, zamiast dopytywać o brakujące szczegóły.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Dlaczego "strona wygląda na zepsutą" nie jest zgłoszeniem błędu?
To opis odczucia, a nie wyniku, więc programista nie ma z czym tego porównać. Zgłoszenie wymaga dwóch osobnych wierszy: co interfejs miał pokazać i co dokładnie pojawiło się zamiast tego, w tym treść błędu lub pusty ekran. Porównaj to z "oczekiwano komunikatu 'Nieprawidłowy kod', pojawiła się pusta biała strona bez wpisów w konsoli", co wskazuje wprost, co sprawdzić.
Jak kroki do odtworzenia wpływają na wagę i priorytet?
Osoba oceniająca zgłoszenie bez pełnych kroków musi zgadywać zarówno szkody powodowane przez błąd, jak i pilność naprawy. Warunki wstępne, ponumerowane działania, oczekiwany wynik, faktyczny wynik i środowisko razem mówią, co naprawdę się psuje i u kogo. Bez któregokolwiek z tych pól waga i priorytet stają się szacunkami, a nie decyzjami.
Co wściekłe i martwe kliknięcia wnoszą do zgłoszenia błędu?
Oznaczają w nagraniu sesji dokładny moment, w którym użytkownik trafił na awarię. Ten znacznik czasu eliminuje zgadywanie, od którego miejsca nagrania zacząć szukać błędu. W połączeniu z automatycznie dołączonymi krokami do odtworzenia programista przechodzi prosto do awarii, zamiast przewijać całą sesję.
Do których narzędzi Flowsery automatycznie dołącza kroki do odtworzenia?
Flowsery automatycznie dołącza nagranie sesji i kroki do odtworzenia do każdego problemu, który trafia do Slacka, Linear lub Jira. Programista ogląda dokładną sekwencję kliknięć i wpisów, zamiast polegać na pamięci zgłaszającego. Oznaczenie @flowsery w tym samym wątku na Slacku może też otworzyć roboczy pull request, gdy poprawka jest już jasna.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Szablon zgłoszenia błędu, którego recenzenci nie odrzucą
Szablon zgłoszenia błędu wymienia każde pole, jakiego oczekuje recenzent, od kroków odtworzenia po ważność, więc niepełne zgłoszenia odpadają, zanim zajmie się nimi inżynier.


Co siedmiu dostawców publikuje o retencji danych z odtwarzania sesji
Retencja danych z odtwarzania sesji według dokumentacji FullStory, Hotjar, Clarity, LogRocket, PostHog, Sentry i Datadog oraz wymagania RODO.


Skąd pochodzą dane w odtwarzaniu sesji i mapach cieplnych
Odtwarzanie sesji a mapy cieplne: jedna wizyta kontra wiele oraz to, jak Hotjar, Datadog, PostHog, Clarity i FullStory tworzą mapy z nagrań lub niezależnie od nich.


Co nagrywa rrweb i jak działają jego opcje prywatności
Jak rrweb zapisuje sesję jako zrzut DOM i mutacje, a nie wideo: pakiety npm, licencja MIT i opcje prywatności, takie jak maskAllInputs i blockClass.


Jak działa częstotliwość próbkowania odtwarzania sesji w Sentry, PostHog i innych
Częstotliwość próbkowania odtwarzania sesji określa, jaka część wizyt jest nagrywana. Zobacz, jak opisują ją Sentry, PostHog, LogRocket, Datadog i Clarity.


Czego RODO naprawdę wymaga od odtwarzania sesji
Ocena odtwarzania sesji pod kątem RODO opiera się na czterech kwestiach: podstawie z art. 6, danych szczególnych kategorii z art. 9, zgodzie z art. 5 ust. 3 ePrivacy i DPIA.
Powiązane artykuły


Czym naprawdę różnią się wściekłe kliknięcia od martwych kliknięć
Wściekłe i martwe kliknięcia różnią się przyczyną, a nie wagą problemu. Oto progi wykrywania publikowane przez PostHog, Hotjar, FullStory, LogRocket i Clarity.


Gdzie domyślne ustawienia redakcji PII w nagraniach sesji odsłaniają dane
Domyślna redakcja PII w nagraniach sesji bardzo się różni: rrweb maskuje tylko hasła, Sentry cały tekst, a Clarity liczby i adresy e-mail.


Jak bardzo odtwarzanie sesji spowalnia stronę?
Czy odtwarzanie sesji spowalnia stronę? Odpowiedź na podstawie opublikowanych danych rrweb i Sentry o rozmiarze skryptu, CPU wątku głównego i wysyłce danych.

