Offline-Fallback-Seite erstellen

Was haben die Google Assistant App, die Slack App, die Zoom App und fast jede andere plattformspezifische App auf Ihrem Smartphone oder Computer gemeinsam? Richtig, Sie erhalten immer mindestens etwas. Auch ohne Netzwerkverbindung können Sie die Assistant App öffnen, Slack aufrufen oder Zoom starten. Möglicherweise erhalten Sie nicht unbedingt etwas besonders Sinnvolles oder können Ihr Ziel nicht erreichen, aber Sie erhalten zumindest etwas und die App ist unter Kontrolle.

In der mobilen Google Assistant App, wenn Sie offline sind
Google Assistant.

Die mobile Slack-App im Offlinemodus
Slack.

Die mobile Zoom App im Offlinemodus
Zoom.

Bei plattformspezifischen Apps erhalten Sie auch ohne Netzwerkverbindung immer etwas.

Im Web erhalten Sie dagegen traditionell nichts, wenn Sie offline sind. In Chrome gibt es nur das Offline-Dinospiel.

Mobile Google Chrome App, in der das Offline-Dinospiel angezeigt wird
Google Chrome für iOS.

Google Chrome-Desktop-App mit dem Offline-Dino-Spiel
Google Chrome für macOS.

Wenn Sie im Web keine Netzwerkverbindung haben, erhalten Sie standardmäßig keine Daten.

Eine Offline-Fallback-Seite mit einem benutzerdefinierten Service Worker

Das muss aber nicht so sein. Mit Service Workers und der Cache Storage API können Sie Ihren Nutzern eine personalisierte Offlinenutzung bieten. Das kann eine einfache Markenseite mit der Information sein, dass der Nutzer derzeit offline ist. Es kann aber auch eine kreativere Lösung sein, wie z. B. das berühmte Trivago-Offline-Labyrinthspiel mit einer manuellen Schaltfläche Verbinden und einem Countdown für den automatischen Verbindungsversuch.

Die trivago-Offlineseite mit dem trivago Offline-Labyrinth
Das Trivago-Offline-Labyrinth.

Service Worker registrieren

Dazu wird ein Dienst-Worker verwendet. Sie können einen Dienst-Worker wie im folgenden Codebeispiel auf Ihrer Startseite registrieren. Normalerweise geschieht dies, sobald die App geladen ist.

window.addEventListener("load", () => {
  if ("serviceWorker" in navigator) {
    navigator.serviceWorker.register("service-worker.js");
  }
});

Der Service Worker-Code

Der Inhalt der eigentlichen Service Worker-Datei mag auf den ersten Blick etwas kompliziert erscheinen, aber die Kommentare im Beispiel unten sollten für Klarheit sorgen. Der Grundgedanke besteht darin, eine Datei namens offline.html vorab im Cache zu speichern, die nur bei fehlerhaften Navigationsanfragen ausgeliefert wird, und den Browser alle anderen Fälle bearbeiten zu lassen:

/*
Copyright 2015, 2019, 2020, 2021 Google LLC. All Rights Reserved.
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
*/

// Incrementing OFFLINE_VERSION will kick off the install event and force
// previously cached resources to be updated from the network.
// This variable is intentionally declared and unused.
// Add a comment for your linter if you want:
// eslint-disable-next-line no-unused-vars
const OFFLINE_VERSION = 1;
const CACHE_NAME = "offline";
// Customize this with a different URL if needed.
const OFFLINE_URL = "offline.html";

self.addEventListener("install", (event) => {
  event.waitUntil(
    (async () => {
      const cache = await caches.open(CACHE_NAME);
      // Setting {cache: 'reload'} in the new request ensures that the
      // response isn't fulfilled from the HTTP cache; i.e., it will be
      // from the network.
      await cache.add(new Request(OFFLINE_URL, { cache: "reload" }));
    })()
  );
  // Force the waiting service worker to become the active service worker.
  self.skipWaiting();
});

self.addEventListener("activate", (event) => {
  event.waitUntil(
    (async () => {
      // Enable navigation preload if it's supported.
      // See https://developers.google.com/web/updates/2017/02/navigation-preload
      if ("navigationPreload" in self.registration) {
        await self.registration.navigationPreload.enable();
      }
    })()
  );

  // Tell the active service worker to take control of the page immediately.
  self.clients.claim();
});

self.addEventListener("fetch", (event) => {
  // Only call event.respondWith() if this is a navigation request
  // for an HTML page.
  if (event.request.mode === "navigate") {
    event.respondWith(
      (async () => {
        try {
          // First, try to use the navigation preload response if it's
          // supported.
          const preloadResponse = await event.preloadResponse;
          if (preloadResponse) {
            return preloadResponse;
          }

          // Always try the network first.
          const networkResponse = await fetch(event.request);
          return networkResponse;
        } catch (error) {
          // catch is only triggered if an exception is thrown, which is
          // likely due to a network error.
          // If fetch() returns a valid HTTP response with a response code in
          // the 4xx or 5xx range, the catch() will NOT be called.
          console.log("Fetch failed; returning offline page instead.", error);

          const cache = await caches.open(CACHE_NAME);
          const cachedResponse = await cache.match(OFFLINE_URL);
          return cachedResponse;
        }
      })()
    );
  }

  // If our if() condition is false, then this fetch handler won't
  // intercept the request. If there are any other fetch handlers
  // registered, they will get a chance to call event.respondWith().
  // If no fetch handlers call event.respondWith(), the request
  // will be handled by the browser as if there were no service
  // worker involvement.
});

Die Offline-Fallback-Seite

In der Datei offline.html können Sie kreativ werden, sie an Ihre Anforderungen anpassen und Ihr Branding hinzufügen. Im folgenden Beispiel sehen Sie nur das Minimum, was möglich ist. Sie veranschaulicht sowohl das manuelle Aktualisieren über das Drücken einer Schaltfläche als auch das automatische Aktualisieren anhand des online-Ereignisses und reguläres Server-Polling.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />

    <title>You are offline</title>

    <!-- Inline the page's stylesheet. -->
    <style>
      body {
        font-family: helvetica, arial, sans-serif;
        margin: 2em;
      }

      h1 {
        font-style: italic;
        color: #373fff;
      }

      p {
        margin-block: 1rem;
      }

      button {
        display: block;
      }
    </style>
  </head>
  <body>
    <h1>You are offline</h1>

    <p>Click the button below to try reloading.</p>
    <button type="button">⤾ Reload</button>

    <!-- Inline the page's JavaScript file. -->
    <script>
      // Manual reload feature.
      document.querySelector("button").addEventListener("click", () => {
        window.location.reload();
      });

      // Listen to changes in the network state, reload when online.
      // This handles the case when the device is completely offline.
      window.addEventListener('online', () => {
        window.location.reload();
      });

      // Check if the server is responding and reload the page if it is.
      // This handles the case when the device is online, but the server
      // is offline or misbehaving.
      async function checkNetworkAndReload() {
        try {
          const response = await fetch('.');
          // Verify we get a valid response from the server
          if (response.status >= 200 && response.status < 500) {
            window.location.reload();
            return;
          }
        } catch {
          // Unable to connect to the server, ignore.
        }
        window.setTimeout(checkNetworkAndReload, 2500);
      }

      checkNetworkAndReload();
    </script>
  </body>
</html>

Demo

In der unten eingebetteten Demo können Sie die Offline-Fallback-Seite in Aktion sehen. Wenn Sie interessiert sind, können Sie sich den Quellcode auf Glitch ansehen.

Hinweis zur Installation Ihrer App

Ihre Website hat jetzt eine Offline-Fallback-Seite. Was sind die nächsten Schritte? Damit Ihre App installiert werden kann, müssen Sie ein Manifest der Web-App hinzufügen und optional eine Installationsstrategie entwickeln.

Hinweis zum Bereitstellen einer Offline-Fallback-Seite mit Workbox.js

Vielleicht haben Sie schon von Workbox gehört. Die Workbox umfasst eine Reihe von JavaScript-Bibliotheken für die Offlineunterstützung zu Web-Apps. Wenn Sie selbst weniger Dienstworker-Code schreiben möchten, können Sie das Workbox-Rezept für eine nur offline verfügbare Seite verwenden.

Im nächsten Abschnitt erfahren Sie, wie Sie eine Installationsstrategie für Ihre App definieren.