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
- Porównaj godziny. Błąd kilka sekund przed zgłoszeniem to mocny trop. Błąd sprzed dłuższego czasu może być szumem.
- Dopasuj go do pinezki. Pinezka i zrzut pokazują, co klient kliknął. Jeśli błąd dotyczy tej samej funkcji, masz punkt startu.
- Odtwórz w tym samym kontekście. Ta sama przeglądarka, ten sam rozmiar okna (jest w zgłoszeniu), ten sam adres.
- 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.