Zum Hauptinhalt springen




Das Melden von Problemen, die Sie in Ihrem Browser finden, an Browseranbieter ist ein wesentlicher Bestandteil der Verbesserung der Webplattform.


Aktualisiert

Einen guten Fehler zu melden ist nicht schwierig, aber es erfordert ein wenig Arbeit. Das Ziel ist es, es einfach zu machen, was kaputt ist, die Ursache zu finden und vor allem einen Weg zu finden, es zu beheben. Fehler, die schnell fortschreiten, sind in der Regel leicht zu reproduzieren, wobei ein klares Verhalten erwartet wird.

Stellen Sie sicher, dass es sich um einen Fehler handelt

Der erste Schritt besteht darin, herauszufinden, was das "richtige" Verhalten sein sollte.

Was ist das richtige Verhalten?

Siehe die relevanten API-Dokumente unter MDNoder versuchen Sie, verwandte Spezifikationen zu finden. Diese Informationen können Ihnen bei der Entscheidung helfen, welche API tatsächlich defekt ist, wo sie defekt ist und wie das erwartete Verhalten ist.

Funktioniert es in einem anderen Browser?

Verhalten, das sich zwischen Browsern unterscheidet, wird im Allgemeinen eher als Interop-Problem priorisiert, insbesondere wenn der Browser, der den Fehler enthält, ein fremder ist. Versuchen Sie, die neuesten Versionen von Chrome, Firefox, Safari und Edge zu testen, möglicherweise mit einem Tool wie BrowserStack.

Überprüfen Sie nach Möglichkeit, ob sich die Seite aufgrund der Ablaufverfolgung durch Benutzeragenten nicht absichtlich anders verhält. Versuchen Sie es in Chrome DevTools Konfigurieren der User-Agent Zeichenfolge zu einem anderen Browser.

Ist es bei einer kürzlich erschienenen Veröffentlichung kaputt gegangen?

Hat es in der Vergangenheit wie erwartet funktioniert, ist aber in einer neueren Browserversion kaputt gegangen? Auf solche "Regressionen" kann viel schneller reagiert werden, insbesondere wenn Sie eine Versionsnummer angeben, bei der es funktioniert hat, und eine Version, bei der es fehlgeschlagen ist. Werkzeuge wie
BrowserStack können das Auschecken älterer Versionen des Browsers erleichtern.

Wenn ein Problem zurückgegangen und reproduzierbar ist, kann die Grundursache normalerweise schnell gefunden und behoben werden.

Sehen andere das gleiche Problem?

Wenn Sie Probleme haben, sind es wahrscheinlich auch andere Entwickler. Versuchen Sie zunächst, den Fehler in zu suchen Paketüberfluss. Dies kann Ihnen helfen, ein abstraktes Problem in eine bestimmte kaputte API zu übersetzen und eine kurzfristige Lösung zu finden, bis der Fehler behoben ist.

Wurde schon mal darüber berichtet?

Sobald Sie eine Vorstellung davon haben, was der Fehler ist, ist es an der Zeit zu überprüfen, ob der Fehler bereits gemeldet wurde, indem Sie die Fehlerdatenbank des Browsers durchsuchen.

Wenn Sie einen vorhandenen Fehler finden, der das Problem beschreibt, fügen Sie bitte Ihre Unterstützung hinzu, indem Sie den Fehler markieren, mit einem Lesezeichen versehen oder kommentieren. Und auf vielen Websites können Sie sich selbst zur CC-Liste hinzufügen und Updates erhalten, wenn sich der Fehler ändert.

Wenn Sie den Fehler kommentieren möchten, geben Sie bitte Informationen darüber an, wie sich der Fehler auf Ihre Website auswirkt. Vermeiden Sie das Hinzufügen von Kommentaren im „+1“-Stil, da Bugtracker häufig E-Mails für jeden Kommentar senden.

Melden Sie den Fehler

Wenn der Fehler noch nicht gemeldet wurde, ist es an der Zeit, ihn dem Browser-Anbieter zu melden.

Erstellen Sie einen minimierten Testfall

Mozilla hat einen großartigen Artikel auf
wie man einen minimierten Testfall erstellt. Um es kurz zu machen: Eine Beschreibung des Problems ist zwar ein guter Anfang, aber nichts geht über die Bereitstellung einer Demo, die mit dem Fehler verknüpft ist, der das Problem zeigt. Um die Chance auf einen schnellen Fortschritt zu maximieren, sollte das Beispiel den minimal möglichen Code enthalten, der zum Veranschaulichen des Problems erforderlich ist. Ein minimales Codebeispiel ist das erste, was Sie tun können, um die Chancen zu erhöhen, dass Ihr Fehler behoben wird.

Hier sind einige Tipps, um einen Testfall zu minimieren:

  • Laden Sie die Webseite herunter, fügen Sie hinzu

    und überprüfen Sie, ob der Fehler lokal vorhanden ist. Dies erfordert möglicherweise einen aktiven HTTPS-Server, wenn die URL HTTPS verwendet.

  • Testen Sie lokale Dateien in den neuesten Versionen von so vielen Browsern wie möglich.
  • Versuchen Sie, alles in einer Datei zusammenzufassen.
  • Entfernen Sie den Code (beginnend mit Dingen, von denen Sie wissen, dass sie unnötig sind), bis der Fehler verschwunden ist.
  • Verwenden Sie die Versionskontrolle, damit Sie Ihre Arbeit speichern und Fehler rückgängig machen können.

Hosten Sie einen minimierten Testfall

Wenn Sie nach einem guten Ort suchen, an dem Sie Ihren minimierten Testfall hosten können, stehen mehrere gute Orte zur Verfügung:

Beachten Sie, dass viele dieser Websites Inhalte in einem Iframe anzeigen, was dazu führen kann, dass sich Funktionen oder Fehler anders verhalten.

Präsentieren Sie Ihr Problem

Sobald Sie Ihren Testfall minimiert haben, können Sie diesen Fehler melden. Gehen Sie zur richtigen Fehlerverfolgungsseite und erstellen Sie ein neues Problem.

Bitte geben Sie eine klare Beschreibung und die erforderlichen Schritte an, um das Problem zu reproduzieren.

Geben Sie zunächst eine klare Beschreibung an, damit Ingenieure das Problem schnell verstehen und das Problem klassifizieren können.

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

Geben Sie dann die detaillierten Schritte an, die zum Reproduzieren des Problems erforderlich sind. Hier kommt Ihr minimierter Testfall ins Spiel.

What steps will reproduce the problem?
1. Go to https://basic-pwa.glitch.me/, open DevTools and look at the
console tab.
2. Click the Install button in the page, you might need to interact with
the page a bit before it becomes enabled.
3. Click Install on the browser modal install confirmation.

Und schließlich beschreiben Sie die echty erwartet Ergebnis.

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)

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)

Weitere Informationen finden Sie unter Richtlinien zum Schreiben von Fehlerberichten
auf MDN.

Bonus: Fügen Sie einen Screenshot oder Screencast des Problems hinzu

Obwohl es nicht erforderlich ist, kann es in einigen Fällen hilfreich sein, einen Screenshot oder Screencast des Problems hinzuzufügen. Dies ist besonders nützlich in Fällen, in denen die Fehler möglicherweise einige seltsame Schritte erfordern, um sie zu reproduzieren. Es kann oft hilfreich sein, auf einem Screencast oder Screenshot sehen zu können, was passiert.

Umweltdetails einbeziehen

Einige Fehler sind nur auf bestimmten Betriebssystemen oder nur auf bestimmten Arten von Displays (z. B. niedrige oder hohe dpi) reproduzierbar. Stellen Sie sicher, dass Sie Details zu den von Ihnen verwendeten Testumgebungen angeben.

den Fehler einreichen

Senden Sie abschließend den Fehler. Denken Sie dann daran, Ihre E-Mail für Antworten auf den Fehler im Auge zu behalten. In der Regel haben Ingenieure während der Untersuchung und Behebung des Fehlers möglicherweise weitere Fragen, oder wenn sie Schwierigkeiten haben, das Problem zu reproduzieren, wenden sie sich möglicherweise an uns.