Mini-Lektion · Deutsch

So findest und behebst du Fehler auf deiner veröffentlichten Website

Reproduziere eine bereitgestellte fehlerhafte Besucheraktion, bitte einen Assistenten um eine gezielte Korrektur und prüfe nach der Änderung dieselbe Aktion.

Interaktive Lektion startenLektionsnotizen lesen

Für wen ist das gedacht?

Für Menschen, die Fehler finden und beheben möchten, denen Besucher begegnen. Du verwendest eine mitgelieferte defekte Seite. Ein Programmierassistent kann den Code ändern, während du das Problem beschreibst und die Besucheraktion wiederholst.

Bevor du beginnst

Die bereitgestellte separate Übungswebsite und ein Programmierassistent. Ein Sentry-Übungsprojekt ist für den Monitoringteil optional; sende nur die bereitgestellten künstlichen Fehler und nutze keine privaten Besucherdaten.

Geschätzte Dauer: 19–31 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Monitoringanbietereinrichtung und Wartezeit bis zur Erfassung kommen hinzu. Ein lokaler Erfassungsaufruf beweist keine empfangene Warnmeldung.

Was du lernen wirst

  • Reproduziere eine tatsächlich defekte Aktion, statt nur das Laden der Seite zu prüfen.
  • Teile genügend sicheren Kontext für eine gezielte Korrektur durch den Assistenten.
  • Prüfe die korrigierte Aktion und den relevanten Monitoringstatus.

Workshop-Dateien

Schritt 1

Probiere die Besucheraktion aus

Eine Seite kann sich öffnen, obwohl ihre nützliche Funktion defekt ist.

Lass den Assistenten den mitgelieferten public-Ordner über HTTP bereitstellen und öffne die Seite. Aktiviere „Find contact section“. Die mitgelieferte Version practice-R1 sucht absichtlich ein fehlendes Ziel. Deshalb meldet der Status, dass die Contact-Aktion fehlgeschlagen ist.

Nenne dem Assistenten die genaue Schaltfläche, das erwartete Ziel und das sichtbare Ergebnis. Der Contact-Abschnitt kann auf der Seite existieren, obwohl die Schaltfläche ihn nicht erreicht. Eine geladene Startseite allein würde dieses Problem übersehen.

Ein konkretes Beispiel

Eine nützliche Symptombeschreibung lautet: „Ich drückte Find contact section in practice-R1. Ich erwartete den Contact-Abschnitt, aber der Status meldete Contact action failed.“

Nutze das bereitgestellte Beispiel einer defekten Kontaktaktion auf einer separaten Übungswebsite. Reproduziere den Schaltflächenfehler, finde eine gezielte Ursache und ändere nur das Nötige. Hilf mir, dieselbe Aktion zu wiederholen und vorher und nachher zu vergleichen. Ist Monitoring aktiviert, nutze nur künstliche Fehler und mein eigenes Übungsprojekt; sende keine privaten Seiten- oder Formulardaten. Bezeichne ein Problem nicht allein deshalb als behoben, weil es als gelöst markiert wurde.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Finde und repariere einen Fehler auf der veröffentlichten Website

Beginne mit einer fehlgeschlagenen Besucheraktion und nutze dann einen Bericht zur Ursachenfindung.

Monitoring ist nützlich, wenn es ein tatsächliches Symptom mit untersuchbarem Code verbindet. Diese Übungsseite sucht absichtlich ein nicht existentes Kontaktelement; dadurch scheitert die Kontaktaktion.

Wir senden ausschließlich einen festen synthetischen Fehler an dein eigenes Sentry-Projekt. Der Bericht enthält eine Veröffentlichungskennung und Stackposition; das Vorfallsprotokoll verbindet diese Belege mit der versuchten Besucheraufgabe.

Ausgearbeitetes Beispiel

Die Startseite selbst lädt erfolgreich. Der Klick auf „Find contact section“ scheitert, weil das Skript #contact-missing sucht, während im tatsächlichen HTML id=contact steht.

Extra implementation exercise

Warum erkennt eine HTTP-200-Startseitenprüfung diesen Fehler nicht?

Ausgearbeitete Lösung anzeigen

Das HTML kann korrekt laden, während eine spätere JavaScript-Aktion scheitert. Wiederhole die Kontaktaufgabe und nicht nur die Seitenanfrage.

  • Testet die betroffene Interaktion nach dem Laden.
  • Unterscheidet Verfügbarkeit von funktionaler Korrektheit.

Schritt 2

Sammle nur sicheren hilfreichen Kontext

Gib dem Assistenten Nachweise ohne private Besucherdaten.

Gib dem Assistenten Übungsdateien, Seitenversion und das Symptom aus dem vorigen Schritt. Das reicht für den Beginn der Untersuchung dieses lokalen Beispiels, ohne echte Formulareingaben oder Kontoinformationen von Besuchern zu verschicken.

Verwendest du das optionale Sentry-Projekt, richte nur dessen öffentlichen Loaderwert ein und aktiviere Übungsüberwachung, bevor du den kontrollierten Fehler reproduzierst. Prüfe das passende Übungsereignis und seine Daten. Ein Ereignis in Sentry ist etwas anderes als ein Alarm im Postfach.

Ein konkretes Beispiel

Der mitgelieferte zulässige Fehler lautet „Practice: missing contact target“. Ein brauchbares Ereignis kann Übungsrelease und Quellstelle enthalten, ohne echte Nutzernachricht, E-Mail-Adresse oder Kontotoken.

Sentry: Browserloader und eigene Initialisierung

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sende einen kontrollierten Diagnosebericht

Erfasse genug für die Untersuchung, ohne rohe Nutzerinhalte zu senden.

Konfiguriere die öffentliche Projekt-Loader-URL nach START-HERE.txt. Das Skript setzt seinen Initialisierungs-Callback vor dem SDK-Laden, deaktiviert Tracing und Replay und verwendet für diesen festen Übungsfehler eine beforeSend-Zulassungsliste.

Das zurückgegebene Diagnoseereignis schließt Anfrage- und Nutzerdaten, beliebige Zusatzwerte und Breadcrumbs aus. Suchparameter und Fragment werden aus Stackdateinamen entfernt. Prüfe auf echten Websites jede Quelle sensibler Diagnosedaten; sendDefaultPii=false allein garantiert keine Freiheit von personenbezogenen Daten in Freitext oder URLs.

Der beforeSend-Filter ist absichtlich streng: Nur die genaue synthetische Nachricht „Practice: missing contact target“ wird gesendet. Andere Nachrichten werden verworfen. Änderst du ihren Wortlaut, aktualisiere bewusst die Zulassungsliste; sonst ist das fehlende Ereignis erwartbar. Entferne den Filter nicht bloß, um das Dashboard zu beleben; untersuche die zugelassenen Ereignisdaten auf unbeabsichtigte Inhalte.

Kommt kein Ereignis an, prüfe zuerst die feste Nachrichtenzeichenkette und die beforeSend-Zulassungsliste in app.js. Ein nicht passendes Ereignis zeigt jetzt lokal eine Filtermeldung und zählt nicht als gesendet. Der URL-Parser nutzt location.origin als Basis relativer Dateinamen und ersetzt nicht parsbare Dateinamen durch redacted, statt ein möglicherweise sensibles Original weiterzuleiten.

Die dokumentierte Loader-Option data-lazy="no" wird durch script.dataset.lazy="no" gesetzt; sie fordert frühes Laden des vollständigen SDK an. Stackdateinamen behalten nach Entfernung von Suchparametern und Fragment nur HTTP(S)-Ursprung und -Pfad. Andere Schemas werden bereinigt statt unverändert weitergereicht.

Ausgearbeitetes Beispiel

Eine feste Fehlermeldung wie „Practice: missing contact target“ genügt hier. Ein vollständiges Formularobjekt zu senden würde Risiko hinzufügen, ohne das fehlende DOM-Ziel besser auffindbar zu machen.

Sentry: Browserloader und eigene Initialisierung

Extra implementation exercise

Macht das Deaktivieren standardmäßiger personenbezogener Daten beliebige Fehlermeldungen automatisch sicher zum Senden?

Ausgearbeitete Lösung anzeigen

Nein. Prüfe die tatsächlichen Ereignisdaten und begrenze, was dein eigener Code sendet. Personenbezogene Daten können auch ohne standardmäßige Erfassung in Meldungen, URLs, Breadcrumbs und Zusatzwerten stehen.

  • Erkennt weiterhin mögliche private Daten in Anwendungstext und URLs.
  • Bereinigt ausdrücklich und verwendet Zulassungslisten.

Schritt 3

Führe eine gezielte Korrektur durch

Wiederhole nach der Änderung genau die fehlgeschlagene Aktion.

Bitte den Assistenten, das Ziel der defekten Schaltfläche mit dem bestehenden Contact-Abschnitt zu vergleichen. Die mitgelieferte worked-solution/app.js enthält die kleine Zielkorrektur. Lass sie anwenden und die korrigierte Übungsrevision practice-R2 nennen.

Öffne die aktualisierte Seite practice-R2 und aktiviere dieselbe Schaltfläche erneut. Sie sollte Contact erreichen und „Contact section opened.“ zeigen. Nur die Releasebezeichnung zu ändern oder ein Sentry-Problem als gelöst zu markieren ändert das Schaltflächenverhalten nicht.

Ein konkretes Beispiel

Das fehlerhafte Skript sucht #contact-missing, während das HTML Contact unter #contact definiert. Der Assistent kann diese Zuordnung korrigieren. Du beurteilst das Ergebnis, indem du die Schaltfläche erneut benutzt.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ordne den Bericht zu, repariere die Ursache und prüfe erneut

Eine Erledigt-Markierung repariert keinen Code.

Aktiviere Monitoring, löse den synthetischen Fehler aus und finde das tatsächliche Ereignis in deinem Konto. Vergleiche Veröffentlichung und Stackframe mit der mitgelieferten Quelle. Kommt nichts an, prüfe Laden, Blocker, Projektkonfiguration und Netzwerkzustellung, bevor du annimmst, es habe keinen Fehler gegeben.

Ersetze das Skript durch worked-solution/app.js, aktualisiere die Veröffentlichungskennung und wiederhole die Kontaktaktion. Das korrekte Ziel sollte ins Blickfeld scrollen. Ein Problem im Dashboard als gelöst zu markieren ersetzt diese Verhaltensprüfung nicht.

Der Dateiaustausch bildet in der Übung eine Quellcodereparatur ab. Committe auf einer gehosteten Übungswebsite die geänderte app.js und Veröffentlichungskennung, prüfe und deploye diese Revision und teste dann ihre öffentliche URL erneut. Nur Status oder Kennung zu ändern wendet die Selektorreparatur nicht an.

Ausgearbeitetes Beispiel

R1 scheitert an #contact-missing; R2 nutzt #contact. Der aussagekräftige Wiederherstellungsbeleg ist die nun funktionierende Kontaktaktion auf der reparierten Revision.

Extra implementation exercise

Das Problem ist als gelöst markiert, aber das bereitgestellte Skript fragt weiterhin #contact-missing ab. Ist der Fehler repariert?

Ausgearbeitete Lösung anzeigen

Nein. Ein Dashboardstatus ändert kein Skript. Veröffentliche die Reparatur über den Prüfprozess und verifiziere die Aktion auf dieser Revision.

  • Prüft tatsächlichen bereitgestellten Quellcode und Revision.
  • Wiederholt die zuvor fehlgeschlagene Aktion.

Schritt 4

Schließe eine hilfreiche Vorfallnotiz ab

Halte Symptom, Korrektur und Prüfung miteinander verbunden.

Vervollständige incident-record.txt mit ursprünglichem Schaltflächenfehler, kleiner Zielkorrektur und dem Ergebnis derselben Aktion auf der aktualisierten Seite. Veröffentlichst du die Übungsänderung, prüfe genau diese veröffentlichte Version, nicht nur die lokale Datei.

Halte optionale Überwachungsbeobachtungen getrennt fest: ob das ursprüngliche Ereignis Sentry erreichte, ob du einen Alarm eingerichtet hast und ob eine Benachrichtigung tatsächlich ankam. Das Protokoll soll diese reparierte Aufgabe und offene Lücken erklären, nicht die ganze Website für fehlerfrei erklären.

Ein konkretes Beispiel

Eine kurze Vorfallsnotiz verbindet die fehlgeschlagene Contact-Aktion in practice-R1 mit der Zielkorrektur und dem erfolgreichen Nachtest in practice-R2. „Problem gelöst“ allein lässt das Besucherresultat aus.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Deine Aufgabe: schreibe eine nützliche Vorfallsnotiz

Lass die nächste untersuchende Person Ursache und Belege verstehen.

Vervollständige das Vorfallsprotokoll mit bereinigtem Ereignisverweis, betroffener Aktion, Quellframe, Grundursache und erfolgreichem Nachtest. Konfigurierst du einen Alarm, prüfe die tatsächliche Benachrichtigung getrennt von der Ereigniserfassung.

Ergänze in deiner eigenen Übungskopie einen zweiten synthetischen Fehler und wiederhole den Ablauf. Halte Meldungen fest und aktualisiere die Zulassungsliste bewusst; erweitere Monitoring nicht durch beliebige Seiten- oder Formulardaten.

Ausgearbeitetes Beispiel

„Fehlenden Zielselektor von #contact-missing zu #contact repariert; R2-Nachtest bestanden“ ist handlungsfähig. „Sentry hatte einen Fehler; erledigt“ lässt Ursache und Prüfung unbekannt.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Extra implementation exercise

Erstelle eine Vorfallsnotiz und belege die funktionierende reparierte Nutzeraktion.

Ausgearbeitete Lösung anzeigen

Aktiviere den konfigurierten Übungsloader und löse genau den synthetischen Fehler aus. Änderst du den Fehlertext, passe die strenge Zulassungsliste bewusst an; eine verworfene nicht zugelassene Nachricht ist erwartbar. Prüfe das tatsächlich empfangene Ereignis auf Veröffentlichung, Frame und unerwünschte Daten.

Übernimm das mitgelieferte reparierte Skript nach public/app.js und ändere RELEASE in practice-R2. Veröffentliche diese Übungsrevision über den geprüften Ablauf und wiederhole dann Find contact section auf der tatsächlichen bereitgestellten URL. Nur Kennung oder Problemstatus zu ändern kann den Selektor nicht reparieren.

Protokolliere Problemerfassung getrennt von Alarmzustellung. Das Ereignis kann schon sichtbar sein, bevor ein konfigurierter Alarm ankommt; lasse jede Beobachtung bis zur Prüfung offen. Die Referenz-Vorfallsnotiz verbindet Fehler, Frame, Selektoränderung und nutzersichtbaren Nachtest.

  • Verbindet Symptom, Veröffentlichung und Quellursache.
  • Prüft Verhalten und trennt Aussagen über Ereignis- und Benachrichtigungszustellung.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.

Weiterlernen

Weitere Lektionen entdecken