Jak zgłosić błąd w przeglądarce

Informowanie dostawców przeglądarek o problemach, które w nich znajdujesz, jest integralną częścią ulepszania platformy internetowej.

Zgłoszenie błędu wymaga trochę pracy. Twoim celem powinno być maksymalne ułatwienie inżynierom przeglądarki znalezienia błędu, dotarcia do jego głównej przyczyny i, co najważniejsze, znalezienia sposobu na jego naprawienie. Błędy, które szybko się naprawia, zwykle można łatwo odtworzyć i mają jasne oczekiwane zachowanie.

Sprawdź, czy to błąd

Najpierw musisz określić, jakie powinno być „prawidłowe” zachowanie.

Jakie jest prawidłowe działanie?

Sprawdź odpowiednią dokumentację interfejsu API na stronie MDN lub spróbuj znaleźć powiązane specyfikacje. Te informacje pomogą Ci ustalić, który interfejs API jest uszkodzony, gdzie występuje błąd i jakie jest oczekiwane działanie.

Czy działa w innej przeglądarce?

Zachowanie, które różni się w zależności od przeglądarki, jest zwykle traktowane jako problem z interoperacyjnością, zwłaszcza gdy przeglądarka zawierająca błąd jest jedyną, która zachowuje się inaczej. Spróbuj przetestować witrynę w najnowszych wersjach przeglądarek Chrome, Firefox, Safari i Edge, najlepiej za pomocą narzędzia takiego jak BrowserStack.

Jeśli to możliwe, sprawdź, czy strona nie zachowuje się celowo inaczej z powodu wykrywania klienta użytkownika. W Narzędziach deweloperskich w Chrome spróbuj ustawić ciąg User-Agent na inną przeglądarkę.

Czy problem pojawił się w ostatniej wersji?

Czy wcześniej działało to zgodnie z oczekiwaniami, ale przestało działać w ostatniej wersji przeglądarki? Takie regresje można rozwiązać znacznie szybciej, zwłaszcza jeśli podasz numer wersji, w której funkcja działała, i wersji, w której wystąpił błąd. Do sprawdzania starszych wersji przeglądarek możesz używać narzędzi takich jak BrowserStack. Aby wyszukać zmianę, użyj narzędzi takich jak bisect-builds (w przypadku Chromium).

Jeśli problem jest regresją i można go odtworzyć, zwykle można szybko znaleźć i naprawić jego główną przyczynę.

Czy inni użytkownicy mają ten sam problem?

Jeśli masz problemy, jest duża szansa, że inni deweloperzy też je mają. Najpierw spróbuj wyszukać błąd na Stack Overflow. Może to pomóc w przełożeniu abstrakcyjnego problemu na konkretny uszkodzony interfejs API i znalezieniu tymczasowego rozwiązania, dopóki błąd nie zostanie naprawiony.

Czy problem został już wcześniej zgłoszony?

Gdy już wiesz, na czym polega błąd, sprawdź, czy został już zgłoszony, przeszukując bazę danych błędów przeglądarki.

Jeśli znajdziesz istniejący błąd, który opisuje problem, dodaj swoje poparcie, oznaczając go gwiazdką, dodając do ulubionych lub komentując. W wielu witrynach możesz dodać siebie do listy DW i otrzymywać powiadomienia o zmianach dotyczących błędu.

Jeśli zdecydujesz się skomentować błąd, podaj informacje o tym, jak wpływa on na Twoją witrynę. Unikaj dodawania komentarzy w stylu „+1”, ponieważ systemy śledzenia błędów zwykle wysyłają e-maile z każdym komentarzem.

Zgłaszanie błędu

Jeśli błąd nie został wcześniej zgłoszony, należy poinformować o nim dostawcę przeglądarki.

Tworzenie uproszczonego elementu testowania

Mozilla ma świetny artykuł na temat tworzenia zminimalizowanego elementu testowania. Krótko mówiąc, opis problemu to świetny początek, ale nic nie zastąpi linku do wersji demonstracyjnej, która pokazuje problem. Aby zmaksymalizować szanse na szybkie rozwiązanie problemu, przykład powinien zawierać minimalną ilość kodu potrzebną do zademonstrowania problemu. Przykładowy kod o minimalnej długości to najlepszy sposób na zwiększenie szans na naprawienie błędu.

Oto kilka wskazówek, jak zminimalizować element testowania:

  • Pobierz stronę internetową, dodaj <base href="https://original.url"> i sprawdź, czy błąd występuje lokalnie. Jeśli adres URL używa protokołu HTTPS, może to wymagać aktywnego serwera HTTPS.
  • Przetestuj pliki lokalne w najnowszych wersjach jak największej liczby przeglądarek.
  • Spróbuj skondensować wszystko w 1 pliku.
  • Usuwaj kod (zaczynając od elementów, które na pewno są niepotrzebne), aż błąd zniknie.
  • Używaj kontroli wersji, aby zapisywać swoją pracę i cofać błędy.

Hostowanie uproszczonego elementu testowania

Jeśli szukasz dobrego miejsca do hostowania uproszczonego elementu testowania, masz do wyboru kilka dobrych opcji:

Pamiętaj, że kilka z tych witryn wyświetla treści w elemencie iframe, co może powodować inne działanie funkcji lub błędów.

Zgłaszanie problemu

Gdy masz już zminimalizowany element testowania, możesz zgłosić błąd. Przejdź do odpowiedniej witryny śledzenia błędów i utwórz nowe zgłoszenie.

Dodaj jasne opisy i kroki, które pozwolą odtworzyć problem.

Najpierw podaj jasny opis, który pomoże inżynierom szybko zrozumieć, na czym polega problem, i ustalić jego priorytet.

When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.

Następnie podaj szczegółowe kroki, które należy wykonać, aby odtworzyć problem, i opisz oczekiwany i rzeczywisty wynik.

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)

Więcej informacji znajdziesz w wytycznych dotyczących pisania zgłoszeń błędów na stronie MDN.

Dodatkowo: dodaj zrzut ekranu lub screencast przedstawiający problem.

Choć nie jest to wymagane, często warto dodać zrzut ekranu lub screencast przedstawiający problem. Jest to szczególnie przydatne, gdy błędy występują po kilku krokach lub nietypowej aktywności. Nagrania i zrzuty ekranu często lepiej pokazują inżynierom przeglądarki, co się stało.

Podaj szczegóły środowiska.

Niektóre błędy można odtworzyć tylko w określonych systemach operacyjnych lub tylko na określonych typach wyświetlaczy (np. o niskiej lub wysokiej rozdzielczości). Pamiętaj, aby podać szczegóły dotyczące użytych środowisk testowych.

Prześlij zgłoszenie błędu.

Na koniec prześlij błąd. Sprawdzaj, czy w skrzynce odbiorczej nie ma odpowiedzi dotyczących błędu. Podczas analizy inżynierowie mogą mieć dodatkowe pytania. Jeśli będzie mieć trudności z odtworzeniem problemu, może się z Tobą skontaktować.