Programmierfehler lassen sich grob in sechs Kategorien einteilen: Syntax, Laufzeit, Referenz, Netzwerk, Logik sowie Umgebung und Konfiguration. Der Nutzen dieser Einteilung liegt nicht im Vokabular, sondern darin, dass jede Kategorie andere Spuren hinterlässt. Wer die Kategorie kennt, weiß, welcher Fehlertext, welche Anfrage und welcher Screenshot in einen Fehlerbericht gehören.
Dieser Artikel liefert zuerst eine Tabelle für den direkten Einsatz, geht dann die acht häufigsten Frontend-Fehler durch — als Beleg dafür, dass ein und derselbe Fehler in mehrere Kategorien fallen kann — und endet mit dem praktischen Teil: Wie wird aus einem Fehler ein Bericht, den ein Entwickler ohne drei Rückfragen bearbeiten kann.
Warum die Einteilung einen eigenen Artikel verdient
Die meisten Teams haben kein Verständnisproblem mit TypeError. Sie haben Probleme mit drei anderen Dingen:
- Jede rote Zeile in der Konsole wird als Bug bezeichnet, obwohl die Hälfte davon aus Drittanbieter-Skripten und Browser-Erweiterungen stammt;
- „Die Seite reagiert nicht" landet direkt beim Backend, obwohl das Frontend die Antwortstruktur nie behandelt hat;
- Der Bericht sagt „es gibt einen Fehler" und lässt den Entwickler zwanzig Minuten lang fragen, welche Seite, welcher Browser und was geklickt wurde.
Alle drei sind Klassifizierungsprobleme: Die Kategorie bestimmt die Beweise, und die Beweise bestimmen, ob der Bericht direkt bearbeitet werden kann.
Die sechs Kategorien
| Kategorie |
Wann sie auftritt |
Typische Meldung |
Wo die Originalbelege liegen |
| Syntax |
Der Code lässt sich nicht parsen, das ganze Skript stoppt |
Unexpected token, Unexpected end of input |
Die erste rote Zeile in der Konsole (alles danach ist meist Folgefehler) |
| Laufzeit |
Der Code läuft und scheitert an einem Schritt |
TypeError, RangeError, Cannot read properties of undefined |
Konsole plus die auslösende Aktion |
| Referenz |
Eine Variable, ein Feld oder Modul existiert nicht |
ReferenceError, x is not defined, undefined is not a function |
Konsole plus Seiten-URL (welche Route nicht geladen wurde) |
| Netzwerk |
Eine Anfrage scheitert, wird blockiert, ist cross-origin oder läuft in einen Timeout |
4xx / 5xx, blocked by CORS policy, net::ERR_ |
Netzwerk-Panel: URL, Statuscode, Antwort-Header |
| Logik |
Nichts wirft einen Fehler, das Ergebnis ist trotzdem falsch |
Überhaupt kein roter Text |
Schritte, erwartetes vs. tatsächliches Ergebnis, ein Datenbeispiel |
| Umgebung |
Nur auf einer Maschine, in einer Umgebung oder bei einem Konto |
Unabhängige 404er, leere Seite, Assets laden nicht |
Browser- und OS-Version, Viewport, Build- oder Umgebungskennung, Kontorechte |
Die wichtigste Spalte ist die letzte: Sie sagt, was in den Bericht gehört. Ein Logikfehler hat keine Fehlermeldung zum Screenshot machen, also braucht er Schritte und Erwartungen. Ein Netzwerkfehler lässt sich überhaupt nicht per Screenshot erklären, also braucht er die Anfrage selbst.
Syntax, Laufzeit, Logik: die Grenzen sind unscharf
Eine Meldung kann je nach Ursache in verschiedene Kategorien fallen, nicht je nach Wortlaut.
Uncaught TypeError: Cannot read properties of undefined (reading 'map') ist ein Laufzeitfehler — der Code erreichte einen undefined-Wert und rief .map darauf auf. Die Ursache kann aber sein:
- Die Antwortstruktur der Schnittstelle hat sich geändert (Netzwerk);
- Im Initialzustand fehlt ein Standardwert (Logik);
- Eine asynchrone Anfrage war beim Rendern noch nicht zurück (Timing).
„Es wirft einen TypeError" reicht also nicht. Der Bericht braucht die Anfrage, aus der die Daten kamen. Deshalb gehören Konsolenfehler und fehlgeschlagene Anfragen zusammen: Jede Seite allein führt in die Irre.
Die acht häufigsten Frontend-Fehler
| # |
Meldung |
Bedeutet meist |
Wo nachsehen |
| 1 |
TypeError: Cannot read properties of undefined |
Daten fehlen noch, Struktur passt nicht, Optional Chaining fehlt |
Konsole plus Antwort der passenden Anfrage |
| 2 |
ReferenceError: x is not defined |
Variable nicht deklariert, falsche Skriptreihenfolge, Modul fehlt im Bundle |
Konsole plus Skriptreihenfolge im Quelltext |
| 3 |
blocked by CORS policy |
Preflight fehlgeschlagen oder Access-Control-Allow-Origin fehlt |
Konsole plus Preflight-Anfrage im Netzwerk-Panel |
| 4 |
Ein Endpunkt liefert 404 / 500 |
Falscher Pfad, gelöschte Ressource, Serverausnahme |
Netzwerk: URL, Statuscode, Zusammenfassung der Antwort |
| 5 |
Hydration failed because the initial UI does not match |
Server und Client rendern unterschiedliche erste Bildschirme |
Konsole plus betroffene Komponente |
| 6 |
Unhandled promise rejection |
Asynchroner Fehler ohne catch, der Fehler verschwindet |
Konsole plus auslösende Aktion |
| 7 |
Refused to load ... violates Content Security Policy |
CSP erlaubt keine neue Domain oder kein Inline-Skript |
Konsole plus CSP-Response-Header der Seite |
| 8 |
Mixed Content: ... loaded over HTTPS, but requested an insecure resource |
Eine HTTPS-Seite fordert eine HTTP-Ressource an |
Konsole plus blockierte Anfrage im Netzwerk-Panel |
Das lässt sich direkt als Checkliste für Meldungen verwenden: erst die rote Zeile einordnen, dann die Belege aus der rechten Spalte ergänzen.
Fehler, Bug und Defect sind nicht dasselbe
- Ein Fehler ist ein Signal des Systems. Er kann eine Warnung sein, er kann Rauschen sein.
- Ein Bug ist eine Abweichung zwischen Implementierung und Erwartung und braucht meist einen reproduzierbaren Pfad.
- Ein Defect ist das, was die meisten Tracker einen Bug nennen, sobald er in die formale Verwaltung wandert.
Die vollständige Abgrenzung steht in Bug vs. Defect vs. Issue vs. Error. Für alle, die einen Bericht schreiben, reicht ein Satz: Ein Fehler ist ein Hinweis, ein Bug ist ein Schluss. Berichte liefern Hinweise, keine Urteile.
Welche Belege welche Kategorie braucht
| Kategorie |
Der Bericht muss enthalten |
Hilfreich, aber nicht zwingend |
| Syntax / Laufzeit |
Exakte Meldung, Seiten-URL, auslösende Aktion |
Screenshot, kurze Aufnahme |
| Referenz |
Exakte Meldung, fehlgeschlagene Route, angemeldete Rolle |
Struktur der zugehörigen Antwort |
| Netzwerk |
Anfrage-URL, Statuscode, auslösende Aktion, Zeitpunkt |
Ausschnitt der Antwort (auf sensible Felder achten) |
| Logik |
Schritte, erwartetes Ergebnis, tatsächliches Ergebnis, Datenbeispiel |
Bildschirmaufnahme |
| Umgebung |
Browser- und OS-Version, Viewport, Umgebungskennung (Produktion, Staging, Vorschau) |
Kontorechte, Build-Nummer |
Die letzte Zeile wird am häufigsten übersehen: „Das passiert nur auf meinem Rechner" ist selbst die wertvollste Information im Bericht, weil sie die Suche von der ganzen Website auf eine Klasse von Umgebungen verengt.
Belege sammeln, ohne nachzufragen
Der manuelle Weg führt über die DevTools: Konsole und Netzwerk-Panel abfotografieren und Zeitstempel von Hand abgleichen — siehe Browser-Konsole öffnen. Dieser Weg hat drei praktische Probleme: Nicht-technische Kolleginnen und Kollegen machen es nicht, sie erfassen nicht alles, und jemand muss danach die Zeiten zusammenführen.
Der günstigere Weg ist, das Meldewerkzeug mitnehmen zu lassen. Jeder Bericht in BugCapturer enthält automatisch die Seiten-URL (sensible Parameter maskiert), Browser und Betriebssystem, Bildschirm und Viewport, einen Zeitstempel, die wörtlichen Konsolenfehler und fehlgeschlagene Anfragen (4xx/5xx) mit Statuscode. Die meldende Person markiert die Stelle und schreibt einen Satz dazu; die übrigen fünf Spalten kommen von selbst.
Der Unterschied zeigt sich bei der Meldequote. Wer erst die Konsole lernen muss, schließt die meisten nicht-technischen Kollegen aus; direkt auf der Seite zu markieren sorgt dafür, dass sie ein zweites Mal melden.
Braucht das Tracker-Feld „Fehlertyp"?
Wenn im System bereits einige hundert Berichte liegen, verdient ein Feld error_type seinen Platz — aber nur in drei Situationen:
Dieselbe Fehlerklasse kehrt wieder (alle zwei Wochen ein CORS-Fehler): Die Klassifizierung legt ein systematisches Problem offen statt eines Tickets nach dem anderen.
Die meldende Person ist keine Entwicklerin: Die Klassifizierung spart die Rückfrage „Frontend oder Backend".
Ihr messt Qualität: Die Verteilung nach Typ ist fairer als die Verteilung nach Person.
Sind es drei bis fünf Personen mit weniger als zwanzig Berichten pro Woche, ist das Feld nur zusätzliche Tipparbeit. Erst die Belege vollständig machen, dann über Klassifizierung sprechen.
Drei häufige Fehler
- Jede rote Zeile als Bug behandeln: Browser-Erweiterungen, Analyse-Skripte und Adblocker schreiben alle Fehler in die Konsole. Entscheidend ist, ob sich das Verhalten der Seite ändert.
- Warnungen ignorieren: React-Key-Warnungen, Hydration-Warnungen und Deprecation-Hinweise sind keine Bugs, aber oft deren Vorbote.
- Einen 500er direkt ans Backend weiterleiten: Der Statuscode sagt, dass der Server gescheitert ist, aber im Bericht fehlen Anfrage-URL, Parameternamen und Aktion. Ohne diese drei lautet die Antwort immer „bitte erneut reproduzieren".
FAQ
Ist ein Syntaxfehler ein Bug?
Ein Syntaxfehler im Quellcode erreicht normalerweise nicht die Produktion; der Build fängt ihn ab. Erscheint in der Produktion tatsächlich ein SyntaxError, liegt der Fehler in der Release-Kette — ungeprüfter Build oder ein CDN, das eine alte Datei ausliefert — und das ist ein Defect.
Gehören Konsolenwarnungen in den Bericht?
Nur die, die zum Symptom passen. Eine leere Seite plus Hydration-Warnung gehört hinein; ein Deprecation-Hinweis einer Bibliothek nicht — er begräbt den eigentlichen Hinweis.
Ist ein „API 500" ein Frontend- oder Backend-Thema?
Wer es behebt, hängt von eurem Prozess ab, der Berichtinhalt ist identisch: Anfrage-URL, Statuscode, auslösende Aktion, Zeitpunkt und ob es reproduzierbar ist. Zuerst klären, ob das Frontend falsche Parameter gesendet hat oder der Server wirklich ausgefallen ist.
Warum sagt der Entwickler immer „kann ich nicht reproduzieren"?
Weil die Umgebung fehlt, nicht die Schritte: Rechte, Datenmenge, Browserversion, Zeitzone und Feature Flags unterscheiden sich. Ein Umgebungsfeld im Bericht spart diese Runde.
Wie melden nicht-technische Kollegen brauchbare Fehler?
Bring ihnen nicht die DevTools bei. Installiere eine Browser-Erweiterung oder bette einen Feedback-Einstieg in die Seite ein und lass das Werkzeug Konsole und fehlgeschlagene Anfragen sammeln — das ist die Voraussetzung für ein Instant-Feedback-System.