Technologia

Błędy konsoli w zgłoszeniu klienta, bez proszenia o DevTools

Klient nie wyśle Ci błędów z konsoli i nie powinien musieć. Co mówią programiście i jak dostać je automatycznie w każdym zgłoszeniu błędu na stronie.

Przeglądarka z panelem konsoli pełnym czerwonych i bursztynowych pasków oraz dymkiem przypiętym do strony.
Praktyczny poradnik
W tym artykule 7 sekcji

„Przycisk w koszyku nic nie robi.” Otwierasz stronę, dodajesz produkt, klikasz: działa. Odpisujesz: „Możesz otworzyć DevTools, zakładkę Console i przesłać mi to, co na czerwono?” Odpowiedź przychodzi po dwóch dniach jako zdjęcie ekranu laptopa zrobione telefonem, ucięte w połowie. A wystarczyłyby błędy konsoli w zgłoszeniu, dołączone bez niczyjego udziału.

Potrzebna informacja cały czas była na ekranie klienta. Poniżej: co błędy z konsoli mówią programiście, dlaczego klient ich nie przyśle i jak dostawać je z każdym zgłoszeniem, bez dopytywania.

Co błędy i ostrzeżenia z konsoli mówią programiście

Taka linijka oszczędza godzinę zgadywania:

Checkout failed: TypeError: Cannot read properties of undefined (reading 'price')

Z jednej linijki wiesz:

  • Co się zepsuło: zamówienie, a nie styl przycisku.
  • Jaki to rodzaj awarii: kod oczekiwał obiektu, a dostał nic. Pewnie produkt bez ceny albo dane, które się nie wczytały.
  • Czy to Twój kod: komunikat z Twojej obsługi błędów wskazuje na Twój kod. Komunikat z czatu albo tagu analityki wskazuje zupełnie gdzie indziej.
  • Kiedy to się stało: godzina obok godziny zgłoszenia mówi, czy błąd przyszedł z kliknięciem, czy dziesięć minut wcześniej.

Ostrzeżenia są cichsze, ale też się przydają: biblioteka informuje, że funkcja jest przestarzała, skrypt narzeka na brak ustawienia. Same rzadko tłumaczą błąd. Obok błędu często pokazują, co poszło nie tak jako pierwsze.

Dlaczego klient ich nie wyśle

Prośba o konsolę nie działa z powodów, które nie mają nic wspólnego z klientem:

  • DevTools są schowane. Większość ludzi nigdy nie nacisnęła F12, a na telefonie konsoli po prostu nie ma.
  • Moment minął. Zanim klient przeczyta Twojego maila, odświeży stronę i błąd zniknie.
  • Nie wie, co jest ważne. W zapchanej konsoli są dziesiątki linijek. Klient robi zrzut góry, a Twój błąd jest na dole.
  • To kosztuje dodatkową wymianę maili. Każde „czy możesz mi przesłać…” to dzień czekania przy błędzie, którego poprawka zajmie może dziesięć minut.

Dobry szablon zgłoszenia błędu pyta klienta o to, co może dać: co zrobił, czego oczekiwał, co się stało. Kontekst techniczny powinno dopisać narzędzie, nie klient.

Błędy konsoli w zgłoszeniu: jak Zorko dołącza je sam

Gdy klient wysyła zgłoszenie przez widget Zorko, trafia do niego ostatnie 10 błędów i ostatnie 10 ostrzeżeń z konsoli strony, każde z godziną. Obok: adres podstrony, przeglądarka, system i urządzenie, rozmiar okna, dokładna pozycja pinezki na stronie, strona, z której przyszedł, strefa czasowa i język.

Klient nie robi nic więcej. W panelu, w sekcji Technical details zgłoszenia, znajdziesz Console errors i Console warnings jako dwie rozwijane listy.

Co łapie, a czego nie

Tu liczy się precyzja, bo pusta lista nie może Cię zmylić.

Łapie: komunikaty, które kod strony wypisuje przez console.error i console.warn, od chwili załadowania widgetu (ładuje się przy pierwszym ruchu myszą, przewinięciu, dotknięciu albo naciśnięciu klawisza). To obejmuje typowy wzorzec: złap błąd i go zaloguj, w Twoim kodzie i w bibliotekach, które zgłaszają problemy w ten sposób.

Sam nie łapie:

  • nieprzechwyconego wyjątku, który przeglądarka wypisuje sama („Uncaught TypeError…”),
  • nieudanych żądań sieciowych i innych komunikatów, które pisze przeglądarka, a nie strona,
  • niczego, co zalogowano przed załadowaniem widgetu.

Dostajesz treść komunikatu i czas, bez pełnego stack trace. Obiekt przekazany do console.error trafia do zgłoszenia jako zwykły tekst, więc jeśli sam logujesz błędy, zaczynaj komunikat od nazwy funkcji („Checkout failed:”, „Newsletter signup:”). Wtedy już z pierwszego słowa wiadomo, której części strony dotyczy.

Przekaż nieprzechwycone błędy do konsoli

Jeśli chcesz mieć w zgłoszeniach także nieprzechwycone wyjątki, dodaj na stronie kilka linijek. Przepuszczają błędy zgłaszane przez przeglądarkę przez console.error, gdzie widget je widzi:

window.addEventListener('error', (event) => {
  console.error(`Uncaught: ${event.message} (${event.filename}:${event.lineno})`);
});

window.addEventListener('unhandledrejection', (event) => {
  console.error('Unhandled promise rejection:', event.reason);
});

W DevTools zobaczysz te błędy dwa razy (linijka przeglądarki i Twoja), co niczemu nie szkodzi. Błędy ze skryptów z innej domeny pojawią się jako „Script error.”, chyba że skrypt jest ładowany z crossorigin i ma właściwe nagłówki CORS.

Jak czytać zgłoszenie z błędami konsoli

  1. Porównaj godziny. Błąd kilka sekund przed zgłoszeniem to mocny trop. Błąd sprzed dłuższego czasu może być szumem.
  2. Dopasuj go do pinezki. Pinezka i zrzut pokazują, co klient kliknął. Jeśli błąd dotyczy tej samej funkcji, masz punkt startu.
  3. Odtwórz w tym samym kontekście. Ta sama przeglądarka, ten sam rozmiar okna (jest w zgłoszeniu), ten sam adres.
  4. Pusta lista znaczy „brak zalogowanych błędów”, a nie „brak błędu”. Problemy z układem, treścią i CSS nie dotykają konsoli, a nieprzechwycone wyjątki pojawią się tylko wtedy, gdy przekażesz je jak wyżej.

Prywatność: co trafia do zgłoszenia

Widget czyta konsolę strony, na której działa: komunikaty z kodu strony i skryptów, które ta strona ładuje. Nie zapisuje ruchu sieciowego, cookies, naciśnięć klawiszy ani innych kart.

Praktyczna konsekwencja: jeśli Twój kod loguje dane osobowe (adres e-mail, numer zamówienia, token), taka linijka może trafić do zgłoszenia. To i tak dobry powód, żeby usunąć takie logi z produkcji. Na zrzucie ekranu klient ma narzędzie do rozmywania, którym zakryje wrażliwe dane przed wysłaniem. Zgłoszenia są przechowywane w UE, więcej o tym, jak obchodzimy się z danymi.

Policz u siebie

Przejrzyj zgłoszenia błędów od klientów z ostatniego miesiąca i zapisz:

  • ile wymagało dopytania o przeglądarkę, podstronę albo „jakieś błędy”,
  • ile trwało, zanim przyszła odpowiedź.

Przykład: 8 błędów w miesiącu, każdy wymagał jednego dopytania, a każde dopytanie to dzień czekania plus 15 minut pisania i czytania. Wychodzi 8 dni, w których błędy stały w miejscu, i 2 godziny maili. To ilustracja, nie badanie, ale właśnie ta część znika, gdy kontekst przychodzi razem ze zgłoszeniem.

Jeśli dopiero porównujesz narzędzia, zapis konsoli to jedna z rzeczy do sprawdzenia, obok reszty tego, na co patrzeć przy wyborze narzędzia do zbierania uwag na stronie.

Błędy konsoli w każdym zgłoszeniu klienta, bez dopytywania: zacznij za darmo, jeden tag script, bez karty.

FAQ

Czy klient musi otwierać DevTools?

Nie. Widget zbiera komunikaty z konsoli w tle i dołącza je, gdy klient wysyła zgłoszenie.

Czy to działa na telefonie?

Tak. Zapis konsoli działa w każdej przeglądarce, w której działa widget, także na telefonie, gdzie klient nie otworzyłby konsoli, nawet gdyby chciał.

Czy łapie błędy z rozszerzeń przeglądarki?

Raczej nie. Rozszerzenia zwykle uruchamiają swoje skrypty w osobnym kontekście, więc ich komunikaty nie przechodzą przez konsolę strony.

Lista błędów jest pusta. Czyli błędu nie ma?

Nie. To znaczy, że strona nie zalogowała żadnego błędu przez console.error po załadowaniu widgetu. Sprawdź zrzut, przeglądarkę i rozmiar okna, i rozważ przekazywanie nieprzechwyconych błędów jak wyżej.

Nowości Zorko na Twojej skrzynce

Zmiany w produkcie i praktyczne porady dla agencji, mniej więcej raz w miesiącu. Nic więcej.

Wypróbuj w praktyce

Daj klientom prosty sposób, żeby pokazali, o co im chodzi.

Zorko trzyma zrzuty ekranu i nagrania razem z danymi strony, których zespół potrzebuje do poprawki.

Zacznij za darmo Zobacz, jak to działa

Plan darmowy: 1 projekt i 10 zgłoszeń miesięcznie. Bez karty płatniczej.