Fehler bei Hintergrunddiensten beheben

Kayce Basques

Sofia Emelianova

Der Bereich Hintergrunddienste in den Chrome-Entwicklertools enthält eine Reihe von Tools für die JavaScript-APIs, mit denen Ihre Website Updates senden und empfangen kann, auch wenn ein Nutzer Ihre Website nicht geöffnet hat. Ein Hintergrunddienst ist funktional ähnlich einem Hintergrundprozess.

Im Bereich Hintergrunddienste können Sie die folgenden Hintergrunddienste debuggen:

• Abrufen im Hintergrund
• Hintergrundsynchronisierung
• Benachrichtigungen
• Spekulatives Laden
• Push-Nachrichten

In den Chrome-Entwicklertools können Fetch-, Synchronisierungs- und Benachrichtigungsereignisse für drei Tage protokolliert werden, auch wenn die Entwicklertools nicht geöffnet sind. So können Sie prüfen, ob Ereignisse wie erwartet gesendet und empfangen werden.

Zusätzlich zu Ereignissen im Hintergrunddienst können die Entwicklertools:

• Berichte anzeigen, die Chrome bereits über die Reporting API gesendet hat oder demnächst senden wird.
• Sie können den Back-Forward-Cache mit einem Klick testen und Fehler beheben.

Hintergrundabruf

Mit der Background Fetch API kann ein Service Worker große Ressourcen wie Filme oder Podcasts zuverlässig als Hintergrunddienst herunterladen. So protokollieren Sie Hintergrundabrufereignisse für drei Tage, auch wenn DevTools nicht geöffnet ist:

1. Öffnen Sie die Entwicklertools auf einer Seite, die die Background Fetch API verwendet.

2. Gehen Sie zu Anwendung > Hintergrunddienste > Hintergrundabruf und klicken Sie auf  Aufzeichnen.

   

3. Lösen Sie auf Ihrer Seite einige Hintergrundabrufaktivitäten aus. DevTools protokolliert die Ereignisse in der Tabelle.

   

4. Klicken Sie auf ein Ereignis, um die zugehörigen Details im Bereich unter der Tabelle aufzurufen.

5. Sie können DevTools schließen und die Aufzeichnung bis zu drei Tage lang laufen lassen. Klicken Sie auf  Beenden, um die Aufnahme zu beenden.

Hintergrundsynchronisierung

Mit der Background Sync API kann ein Service Worker Daten an einen Server senden, sobald er wieder eine zuverlässige Internetverbindung hergestellt hat. So protokollieren Sie Hintergrundsynchronisierungsereignisse für drei Tage, auch wenn DevTools nicht geöffnet ist:

1. Öffnen Sie die Entwicklertools, z. B. auf dieser Demoseite.

2. Gehen Sie zu Anwendung > Hintergrunddienste > Hintergrundsynchronisierung und klicken Sie auf  Aufzeichnen.

   

3. Klicken Sie auf der Demoseite auf Register background sync (Hintergrundsynchronisierung registrieren), um den entsprechenden Service Worker zu registrieren, und klicken Sie bei Aufforderung auf Allow (Zulassen).

   Die Registrierung von Service Workern ist eine Hintergrundsynchronisierungsaktivität. DevTools protokolliert die Ereignisse in der Tabelle.

   

4. Klicken Sie auf ein Ereignis, um die zugehörigen Details im Bereich unter der Tabelle aufzurufen.

5. Sie können DevTools schließen und die Aufzeichnung bis zu drei Tage lang laufen lassen. Klicken Sie auf  Beenden, um die Aufnahme zu beenden.

(Experimentell) Eindämmung von Bounce-Tracking

Mit dem Experiment zur Eindämmung von Bounce-Tracking in Chrome können Sie den Status von Websites, die anscheinend websiteübergreifendes Tracking mit der Bounce-Tracking-Technik durchführen, identifizieren und löschen. Sie können die Maßnahmen zur Eindämmung des Trackings manuell erzwingen und sich eine Liste der Websites ansehen, deren Status gelöscht wurde.

So erzwingen Sie die Eindämmung von Tracking:

1. Drittanbieter-Cookies in Chrome blockieren Gehen Sie zu  > Einstellungen > Datenschutz und Sicherheit > Cookies und andere Websitedaten > Drittanbieter-Cookies blockieren und aktivieren Sie die Option.
2. Legen Sie in chrome://flags den Test Eindämmung von Bounce-Tracking auf Aktiviert mit Löschung fest.
3. Öffnen Sie die Entwicklertools und rufen Sie Anwendung > Hintergrunddienste > Maßnahmen zur Eindämmung von Bounce-Tracking auf.
4. Klicken Sie auf einen Bounce-Link und warten Sie 10 Sekunden, bis Chrome den Bounce aufzeichnet. Auf dem Tab Probleme werden Sie vor dem bevorstehenden Löschen des Status gewarnt.
5. Klicken Sie auf Force run (Ausführung erzwingen), um den Status sofort zu löschen.

Benachrichtigungen

Nachdem ein Service Worker eine Push-Nachricht von einem Server empfangen hat, verwendet er die Notifications API, um die Daten für einen Nutzer anzuzeigen. So protokollieren Sie Benachrichtigungen für drei Tage, auch wenn die Entwicklertools nicht geöffnet sind:

1. Entwicklertools öffnen

2. Gehen Sie zu Anwendung > Hintergrunddienste > Benachrichtigungen und klicken Sie auf  Aufzeichnen.

   

3. Klicken Sie auf Benachrichtigung planen und dann auf Zulassen, wenn Sie dazu aufgefordert werden.

4. Warte, bis die Benachrichtigung angezeigt wird. DevTools protokolliert die Benachrichtigungsereignisse in der Tabelle.

   

5. Klicken Sie auf ein Ereignis, um die zugehörigen Details im Bereich unter der Tabelle aufzurufen.

6. Sie können DevTools schließen und die Aufzeichnung bis zu drei Tage lang laufen lassen. Klicken Sie auf  Beenden, um die Aufnahme zu beenden.

Spekulative Ladevorgänge

Spekulative Ladevorgänge ermöglichen einen nahezu sofortigen Seitenaufbau basierend auf Spekulationsregeln, die Sie definieren. So kann Ihre Website die meisten aufgerufenen Seiten vorab abrufen und rendern.

Beim Prefetching wird eine Ressource im Voraus abgerufen. Beim Pre-Rendering wird die gesamte Seite in einem verborgenen Hintergrund-Renderingprozess gerendert.

Sie können spekulative Ladevorgänge im Bereich Anwendung > Hintergrunddienste > Spekulative Ladevorgänge debuggen. Der Abschnitt enthält drei Ansichten:

• Spekulative Ladevorgänge Enthält den spekulativen Status für die aktuelle Seite, die aktuelle URL, Seiten, die die aktuelle Seite spekulativ zu laden versucht, und deren Status.
• Regeln Enthält die Regelsätze auf der aktuellen Seite im Bereich Elemente und den Gesamtstatus der Spekulationen.
• Spekulationen: Enthält eine Tabelle mit Informationen zu Versuchen zum spekulativen Laden und deren Status. Wenn ein Versuch fehlgeschlagen ist, können Sie in der Tabelle darauf klicken, um detaillierte Informationen und den Grund für den Fehler aufzurufen.

So können Sie spekulatives Laden auf dieser Prerender-Demoseite debuggen:

1. Öffnen Sie die DevTools auf der Seite und rufen Sie Anwendung > Hintergrunddienste > Spekulative Ladevorgänge auf. Wenn Sie keine spekulativen Ladevorgänge sehen, die von der Seite initiiert wurden, laden Sie sie neu.

   

2. Die Startseite der Demo rendert zwei Seiten vorab, bei einer Seite schlägt das Pre-Rendering fehl. Klicken Sie auf Alle Spekulationen ansehen.

3. Wählen Sie unter Spekulationen die Spekulation mit dem Status Fehler aus, um den Fehlergrund und den Abschnitt mit detaillierten Informationen unten aufzurufen.

   

   In diesem Fall ist das Pre-Rendering fehlgeschlagen, weil es auf der Website keine /next3.html-Seite gibt.

4. Optional können Sie die Tabelle auf dem Tab Spekulationen filtern. Geben Sie dazu in der Filterleiste oben einen Wert ein oder verwenden Sie einen der folgenden Filterschlüssel: url:VALUE, action:VALUE oder action:VALUE.

   

5. Öffnen Sie den Bereich Regeln und klicken Sie auf Status, um den Regelsatz unten aufzurufen. Wenn Sie auf den Link Regelsatz klicken, gelangen Sie zum Steuerfeld Elemente und sehen, wo die Spekulationsregel definiert ist.

   

Eine ausführlichere Anleitung finden Sie unter Spekulationsregeln debuggen.

Push-Benachrichtigungen

Damit einem Nutzer eine Push-Benachrichtigung angezeigt werden kann, muss ein Service Worker zuerst die Push Message API verwenden, um Daten von einem Server zu empfangen. Wenn der Service Worker bereit ist, die Benachrichtigung anzuzeigen, verwendet er die Notifications API. So protokollieren Sie Push-Benachrichtigungen drei Tage lang, auch wenn DevTools nicht geöffnet ist:

1. Öffnen Sie die Entwicklertools, z. B. auf dieser Demoseite.

2. Gehen Sie zu Anwendung > Hintergrunddienste > Push-Messaging und klicken Sie auf  Aufzeichnen.

   

3. Aktivieren Sie auf der Demoseite Push-Benachrichtigungen aktivieren, klicken Sie auf Zulassen, wenn Sie dazu aufgefordert werden, geben Sie eine Nachricht ein und senden Sie sie. DevTools protokolliert Push-Benachrichtigungsereignisse in der Tabelle.

   

4. Klicken Sie auf ein Ereignis, um die zugehörigen Details im Bereich unter der Tabelle aufzurufen.

5. Sie können DevTools schließen und die Aufzeichnung bis zu drei Tage lang laufen lassen. Klicken Sie auf  Beenden, um die Aufnahme zu beenden.

Reporting API

Einige Fehler treten nur in der Produktion auf. Sie sehen sie nie lokal oder während der Entwicklung, da echte Nutzer, Netzwerke und Geräte das Spiel verändern.

Angenommen, Ihre neue Website basiert auf Drittanbietersoftware, die document.write() verwendet, um wichtige Skripts zu laden. Neue Nutzer auf der ganzen Welt öffnen Ihre Website, haben aber möglicherweise langsamere Verbindungen als Sie beim Testen. Ohne dass Sie es wissen, funktioniert Ihre Website für sie nicht mehr, weil Chrome bei document.write() in langsamen Netzwerken eingreift. Alternativ können Sie auch nach APIs suchen, die in Ihrer Codebasis verwendet werden und die eingestellt wurden oder bald eingestellt werden.

Die Reporting API wurde entwickelt, um Ihnen bei der Überwachung von eingestellten API-Aufrufen, Sicherheitsverstößen auf Ihrer Seite und mehr zu helfen. Sie können die Berichterstellung wie unter Webanwendung mit der Reporting API überwachen beschrieben einrichten.

So rufen Sie die von einer Seite generierten Berichte auf:

1. Öffnen Sie die Entwicklertools und rufen Sie Anwendung > Hintergrunddienste > Reporting API auf.

   

Der Tab Reporting API ist in drei Bereiche unterteilt:

• Die Tabelle Berichte mit den folgenden Informationen zu jedem Bericht:
  • URL, die die Berichterstellung ausgelöst hat
  • Art des Verstoßes
  • Status des Berichts
  • Zielendpunkt
  • Zeitstempel Generiert am
  • Bericht Body
• Der Vorschauabschnitt Berichtstext. Wenn Sie sich den Hauptteil eines Berichts in der Vorschau ansehen möchten, klicken Sie in der Tabelle auf einen Bericht.
• Der Bereich Endpunkte mit einer Übersicht aller in der Kopfzeile Reporting-Endpoints konfigurierten Endpunkte.

Berichtsstatus

In der Spalte Status sehen Sie, ob Chrome den Bericht erfolgreich gesendet hat, ihn gerade sendet oder der Versand fehlgeschlagen ist.

Berichte werden nach einer Weile entfernt, unabhängig davon, ob sie erfolgreich gesendet wurden.

Kontext des Absturzberichts

Mit der Reporting API können Sie Ihre Website so konfigurieren, dass Abstürze an einen crash-reporting- oder default-Serverendpunkt gemeldet werden. Ein Absturzbericht kann eine CrashReportContext-Schnittstelle enthalten, mit der Sie beliebige absturzbezogene Daten in Schlüssel/Wert-Paaren für den aktuellen Browsing-Kontext der obersten Ebene aufzeichnen können.

Auf dem Tab Anwendung > Hintergrunddienste > Reporting API > Crash Report Context (Kontext für Absturzberichte) können Sie Ihre Absturzkontextdaten ansehen und oben in der Filterleiste nach Schlüssel oder Wert filtern.

Gerätegebundene Sitzungen

Anmeldedaten für gerätegebundene Sitzungen (Device Bound Session Credentials, DBSC) ist eine Web-API und ein Protokoll zwischen User-Agents und Servern, das Cookie-Diebstahl verhindern soll. Dazu kann ein User-Agent nachweisen, dass er einen sicher gespeicherten privaten Schlüssel besitzt.

So rufen Sie die gerätegebundenen Sitzungen, ihre Definitionen und Ereignisse auf:

1. Öffnen Sie die Entwicklertools auf einer Seite, auf der DBSC verwendet wird.
2. Gehen Sie zu Anwendung > Hintergrunddienste > Gerätegebundene Sitzungen.

3. Maximieren Sie in der Seitenleiste links eine Website, um die aktiven Sitzungen aufzurufen. Wählen Sie eine Sitzung aus, um die Definition aufzurufen.

   

4. In der Tabelle Events werden die DBSC-Ereignisse protokolliert: Erstellung, Aktualisierung, Challenge und Beendigung. Wenn Sie die Liste der Ereignisse bei Seitenwechseln beibehalten möchten, aktivieren Sie check_box Protokoll beibehalten.

5. Wählen Sie in der Tabelle Ereignisse ein Ereignis aus, um die zugehörigen Details zu sehen.

6. Wenn ein Ereignis fehlschlägt, wird in der Spalte Ergebnis die Meldung Error angezeigt. Wählen Sie das fehlgeschlagene Ereignis aus, um die Details, den Antwortfehlercode und die Ursache des Fehlers aufzurufen.

   

Im Bereich An Gerät gebundene Sitzungen in der Seitenleiste werden möglicherweise die folgenden Probleme hervorgehoben:

• Beendete Sitzungen: In der Seitenleiste durch eine durchgestrichene Schrift und ein Symbol für „Datenbank aus“ gekennzeichnet.
• Fehlgeschlagene Ereignisse: Mit einem Warnsymbol hervorgehoben. Das Element Keine Sitzung erfasst fehlgeschlagene Ereignisse, die mit einer Website, aber nicht mit einer bekannten Sitzung verknüpft waren.