Alles, was eine entwickelnde Person zum Nachstellen eines Fehlers braucht, ist während des Vorfalls auf Ihrem Bildschirm: die Seite, die Konsole, die Anfragen, der Browser, in dem Sie gerade sind. Zehn Sekunden später ist der Tab geschlossen und alles davon ist weg, und deshalb enden Fehlerberichte als Sätze, die aus dem Gedächtnis geschrieben wurden.

So erfassen Sie stattdessen das Ganze, mit der Erweiterung, die wir bauen. Beim ersten Mal dauert es etwa eine Minute, danach ein paar Sekunden. Für das Einreichen eines Berichts wird kein Konto benötigt.

Installieren

Session Replay

Kostenlose Chrome-Erweiterung. Ein Klick auf der Seite, die sich falsch verhält, erfasst den Screenshot, die Konsole und das Netzwerkprotokoll und gibt Ihnen einen Link, den Sie ins Ticket einfügen können.

Erweiterung holen

Chrome und Chromium-Browser, aus dem Web Store. Danach ist nichts zu konfigurieren.

Den Fehler erfassen

Öffnen Sie die Seite, die sich falsch verhält, und klicken Sie dann auf das Symbol der Erweiterung in der Symbolleiste.

Das Panel der Erweiterung im selben Fenster wie die gemeldete Seite: die Seite behält links ihren Platz, und das Panel sitzt rechts daneben, mit dem Screenshot und den Aufnahmesteuerungen.

Wählen Sie Screenshot oder Aufnahme. Ein Screenshot passt für alles, was auf einen Blick zu sehen ist - ein kaputtes Layout, eine falsche Summe, eine Fehlermeldung. Eine Aufnahme passt für alles mit einer Abfolge oder einem zeitlichen Verlauf darin: der Knopf, der erst beim zweiten Klick funktioniert, der Ladekreis, der nie aufhört. Die Aufnahme endet nach zehn Minuten und behält alles bis dahin, sodass eine lange Aufnahme nie an einer Grenze verloren geht, die niemand erwähnt hat.

Zeichnen Sie auf dem Screenshot, wenn es hilft. Frei Hand, in der Farbe Ihrer Wahl. Ein Kreis um die falsche Zahl spart einen ganzen Absatz darüber, welche Zahl falsch ist.

Fügen Sie eine Beschreibung hinzu, wenn Sie eine haben. Optional, und die fünfzehn Sekunden wert: was Sie erwartet haben. Das ist das eine, was die Aufzeichnung nicht wissen kann.

Was ohne Ihr Zutun erfasst wird

Das ist der Teil, der den Bericht lesenswert macht, und nichts davon verlangt, dass Sie die Entwicklerwerkzeuge öffnen:

  • Browser, Version, Betriebssystem und Bildschirmgröße, die entscheiden, ob ein Defekt allgemein ist oder nur Sie betrifft
  • Konsolenausgabe, einschließlich des Fehlers, der ausgegeben wurde, während niemand hinsah
  • Das Netzwerkprotokoll, mit Status und Zeiten jeder Anfrage, die die Seite gestellt hat - und einer HAR-Datei, die Sie herunterladen und in den Entwicklerwerkzeugen öffnen können
  • Was Sie getan haben: die Klicks, Eingaben und Seitenwechsel, die dahin geführt haben, in ihrer Reihenfolge, und genau das macht aus einem Bericht eine Anleitung zum Nachstellen

Eines ist bewusst einzuschalten. Setzen Sie das Häkchen bei den Antwortinhalten vor der Aufnahme, dann hängt sich die Erweiterung an Chromes Debugger, sodass der Bericht enthält, was der Server tatsächlich zurückgeschickt hat, statt nur die Anfragezeile. Es ist aus, solange Sie es nicht einschalten, und Chrome zeigt die ganze Zeit sein eigenes Hinweisband.

Weitergeben

Sie bekommen einen Link. Fügen Sie ihn dort ein, wo die Arbeit stattfindet - ins Ticket, in den Pull Request, in den Chat. Wer ihn öffnet, sieht die Aufzeichnung und jeden Reiter mit Kontext daneben, ohne Konto und ohne etwas zu installieren.

Der Link öffnet die Aufzeichnung, daneben auf Reitern die Konsole, das Netzwerkprotokoll und die Browserangaben.

Ein Freigabelink ist zunächst öffentlich. Das macht ihn leicht zu verschicken, und es ist gut, das zu wissen, bevor Sie eine Seite mit personenbezogenen Daten oder einem internen System erfassen. Wenn Ihnen die Domain gehört und Sie in einem kostenpflichtigen Tarif sind, können Sie das ändern: Berichte können privat beginnen und sind dann nur für die meldende Person und Ihr Team sichtbar, und jeder Bericht lässt sich später in beide Richtungen umstellen.

Legen Sie ein kostenloses Konto an, wenn Ihre Berichte an einem Ort und ohne Tageslimit bleiben sollen und Sie sehen möchten, wann sie geöffnet wurden. Zum Einreichen ist es nie erforderlich.

Der Teil, den das Werkzeug nicht übernimmt

Eine Aufzeichnung ist ein Beleg. Sie ist kein Bericht.

Sie weiß nicht, was Sie erwartet haben, ob die beiden Merkwürdigkeiten, die Ihnen aufgefallen sind, ein Defekt sind oder zwei, oder wie wichtig das im Vergleich zu allem anderen in der Warteschlange ist. Das ist Urteilsvermögen, und es bleibt bei der Person, die dabei war, und deshalb ist das Beschreibungsfeld die fünfzehn Sekunden wert, obwohl alles andere automatisch geschieht.

Wenn Sie die Form eines Berichts wollen, der behoben statt zurückgefragt wird, hat der Leitfaden zum Fehlerbericht sie, und seine Vorlage ist eine Datei, die Sie neben Ihrem Tracker behalten können. Die zehn häufigsten Fehler sind dieselbe Liste von der anderen Seite.

Die kurze Fassung

Einmal installieren. Auf der Seite, die sich falsch verhält, auf das Symbol klicken, Screenshot oder Aufnahme wählen, sagen, was Sie erwartet haben, den Link verschicken. Die Browserangaben, die Konsole, das Netzwerkprotokoll und die Abfolge Ihrer Schritte kommen mit, und der einzige Teil, der Ihnen bleibt, ist das Urteil, das immer Ihres war.