Browseranbieter über Probleme zu informieren, die Sie in ihrem Browser finden, ist ein wichtiger Bestandteil der Verbesserung der Webplattform.
Einen guten Fehlerbericht zu erstellen, erfordert etwas Arbeit. Ihr Ziel sollte es sein, es Browser-Entwicklern so einfach wie möglich zu machen, den Fehler zu finden, die Ursache zu ermitteln und vor allem eine Lösung zu finden. Fehler, die schnell behoben werden, lassen sich in der Regel schnell reproduzieren und haben ein klares erwartetes Verhalten.
Prüfen, ob es sich um einen Fehler handelt
Zuerst müssen Sie herausfinden, wie das „richtige“ Verhalten aussehen sollte.
Wie verhältst du dich richtig?
Sehen Sie sich die entsprechenden API-Dokumente auf MDN an oder suchen Sie nach zugehörigen Spezifikationen. Anhand dieser Informationen können Sie entscheiden, welche API tatsächlich fehlerhaft ist, wo der Fehler liegt und wie das erwartete Verhalten ist.
Funktioniert es in einem anderen Browser?
Verhalten, das sich zwischen Browsern unterscheidet, wird im Allgemeinen als Interoperabilitätsproblem höher priorisiert, insbesondere wenn der Browser mit dem Fehler der einzige ist, der sich anders verhält. Versuche, die Tests mit den aktuellen Versionen von Chrome, Firefox, Safari und Edge durchzuführen, eventuell mit einem Tool wie BrowserStack.
Prüfe nach Möglichkeit, ob sich die Seite aufgrund von User-Agent-Sniffing absichtlich anders verhält. Versuchen Sie, in den Chrome-Entwicklertools den String User-Agent auf einen anderen Browser festzulegen.
Ist es in einer kürzlich veröffentlichten Version kaputtgegangen?
Hat dies in der Vergangenheit wie erwartet funktioniert, ist aber in einer neueren Browserversion fehlerhaft? Solche Regressionen können viel schneller behoben werden, insbesondere wenn Sie eine Versionsnummer angeben, bei der es funktioniert hat, und eine Version, bei der es fehlgeschlagen ist. Mit Tools wie BrowserStack können Sie alte Browserversionen prüfen. Verwenden Sie Tools wie das bisect-builds-Tool (für Chromium), um nach der Änderung zu suchen.
Wenn ein Problem eine Regression ist und reproduziert werden kann, lässt sich die Ursache in der Regel schnell finden und beheben.
Tritt das Problem auch bei anderen auf?
Wenn Sie Probleme haben, ist es wahrscheinlich, dass andere Entwickler sie auch haben. Suchen Sie zuerst auf Stack Overflow nach dem Fehler. So können Sie ein abstraktes Problem auf eine bestimmte fehlerhafte API zurückführen und möglicherweise eine kurzfristige Problemumgehung finden, bis der Fehler behoben ist.
Wurde es schon einmal gemeldet?
Sobald Sie eine Vorstellung davon haben, worum es sich bei dem Fehler handelt, sollten Sie in der Fehlerdatenbank des Browsers nachsehen, ob der Fehler bereits gemeldet wurde.
- Chromium-basierte Browser: https://crbug.com
- Firefox: https://bugzilla.mozilla.org/
- Safari und WebKit-basierte Browser: https://bugs.webkit.org/
Wenn Sie einen vorhandenen Fehler finden, der das Problem beschreibt, können Sie ihn mit einem Sternchen, einem Favoriten oder einem Kommentar versehen. Auf vielen Websites können Sie sich auch selbst zur CC-Liste hinzufügen und Updates erhalten, wenn sich der Fehler ändert.
Wenn du den Fehler kommentieren möchtest, gib an, wie sich der Fehler auf deine Website auswirkt. Vermeide Kommentare wie „+1“, da Bugtracker in der Regel für jeden Kommentar E-Mails senden.
Fehler melden
Wenn der Fehler noch nicht gemeldet wurde, ist es an der Zeit, den Browseranbieter darüber zu informieren.
Minimierten Testfall erstellen
Mozilla hat einen hervorragenden Artikel zum Erstellen eines minimierten Testfalls veröffentlicht. Kurz gesagt: Eine Beschreibung des Problems ist ein guter Anfang, aber nichts ist besser als eine verlinkte Demo im Fehlerbericht, die das Problem zeigt. Damit wir das Problem schnellstmöglich beheben können, sollte das Beispiel nur den Code enthalten, der zur Veranschaulichung des Problems erforderlich ist. Ein minimales Codebeispiel ist die beste Möglichkeit, die Wahrscheinlichkeit zu erhöhen, dass der Fehler behoben wird.
Hier sind einige Tipps zum Minimieren eines Testlaufes:
- Laden Sie die Webseite herunter, fügen Sie
<base href="https://original.url">hinzu und prüfen Sie, ob der Fehler lokal auftritt. Wenn die URL HTTPS verwendet, ist dafür möglicherweise ein Live-HTTPS-Server erforderlich. - Testen Sie die lokalen Dateien in den neuesten Builds möglichst vieler Browser.
- Versuchen Sie, alles in einer Datei zusammenzufassen.
- Entfernen Sie Code (beginnend mit Dingen, von denen Sie wissen, dass sie nicht erforderlich sind), bis der Fehler nicht mehr auftritt.
- Verwenden Sie die Versionsverwaltung, um Ihre Arbeit zu speichern und Fehler rückgängig zu machen.
Minimierten Testfall hosten
Wenn du nach einem guten Ort suchst, um deinen minimierten Testfall zu hosten, gibt es mehrere gute Möglichkeiten:
Beachte, dass auf mehreren dieser Websites Inhalte in einem iFrame angezeigt werden, was dazu führen kann, dass sich Funktionen oder Fehler anders verhalten.
Problem melden
Sobald Sie Ihren minimierten Testfall haben, können Sie den Fehler melden. Rufen Sie die richtige Website zur Fehlerverfolgung auf und erstellen Sie ein neues Problem.
- Chromium-basierte Browser: https://crbug.com/new
- Firefox: https://bugzilla.mozilla.org/
- Safari und WebKit-basierte Browser: https://bugs.webkit.org/
Fügen Sie klare Beschreibungen und Schritte zur Reproduktion hinzu.
Geben Sie zuerst eine klare Beschreibung an, damit die Entwickler das Problem schnell verstehen und einordnen können.
When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.
Geben Sie als Nächstes die detaillierten Schritte an, die zum Reproduzieren des Problems erforderlich sind, und beschreiben Sie das erwartete und das tatsächliche Ergebnis.
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)
Weitere Informationen finden Sie in den Richtlinien zum Verfassen von Fehlerberichten im MDN.
Bonus: Screenshot oder Screencast des Problems hinzufügen
Es ist zwar nicht erforderlich, aber oft hilfreich, einen Screenshot oder Screencast des Problems hinzuzufügen. Das ist besonders hilfreich, wenn Fehler nach mehreren Schritten oder ungewöhnlichen Aktivitäten auftreten. Screencasts und Screenshots können Browser-Entwicklern oft besser zeigen, was passiert ist.
Details zur Umgebung angeben
Einige Fehler sind nur auf bestimmten Betriebssystemen oder nur auf bestimmten Arten von Displays (z. B. mit niedriger oder hoher DPI) reproduzierbar. Geben Sie unbedingt die Details aller verwendeten Testumgebungen an.
Fehler melden
Senden Sie den Fehlerbericht ab. Achte auf E‑Mails mit Antworten zu dem Fehler. In der Regel haben die Techniker während der Untersuchung zusätzliche Fragen. Wenn sie Schwierigkeiten haben, das Problem zu reproduzieren, werden sie sich möglicherweise an dich wenden.