Was haben die Google Assistant-App, die Slack-App, die Zoom-App und fast alle anderen plattformspezifischen Apps auf Ihrem Smartphone oder Computer gemeinsam? Richtig, sie bieten Ihnen wenigstens immer etwas. Auch wenn keine Netzwerkverbindung besteht, können Sie die Assistant-App öffnen, Slack aufrufen oder Zoom starten. Vielleicht erhalten Sie nichts besonders Bedeutendes oder können sogar nicht in der Lage sein, das zu erreichen, was Sie erreichen wollten, aber zumindest erhalten Sie etwas und die Anwendung behält die Kontrolle.
![die Google Assistant App, wenn du offline bist.](https://web.developers.google.cn/static/articles/offline-fallback-page/image/google-assistant-mobile-a-c1c796df5fae3.jpg?authuser=6&hl=de)
![die mobile Slack App offline nutzen.](https://web.developers.google.cn/static/articles/offline-fallback-page/image/slack-mobile-app-while-of-62be23091324d.jpg?authuser=6&hl=de)
![Mobile Zoom App, wenn du offline bist.](https://web.developers.google.cn/static/articles/offline-fallback-page/image/zoom-mobile-app-while-off-02f0aa84f73c7.jpg?authuser=6&hl=de)
Im Gegensatz dazu erhalten Sie im Web üblicherweise nichts, wenn Sie offline sind. In Chrome gibt es ein Dino-Offlinespiel – aber das ist es schon.
![Mobile Google Chrome App, in der das Dino-Offlinespiel angezeigt wird.](https://web.developers.google.cn/static/articles/offline-fallback-page/image/google-chrome-mobile-app-2434801002fc9.png?authuser=6&hl=de)
![Google Chrome-Desktop-App, in der das Dino-Offlinespiel angezeigt wird.](https://web.developers.google.cn/static/articles/offline-fallback-page/image/google-chrome-desktop-app-986e96e382e5b.png?authuser=6&hl=de)
Offline-Fallback-Seite mit einem benutzerdefinierten Service Worker
Das muss aber nicht so sein. Mit Service Workern und der Cache Storage API können Sie Ihren Nutzern eine individuelle Offlineumgebung bieten. Das kann eine einfache Markenseite mit den Informationen sein, dass der Nutzer gerade offline ist. Aber es kann auch eine kreativere Lösung sein, wie z. B. das berühmte Offline-Labyrinth von Trivago mit der Schaltfläche Wieder verbinden und einem automatischen Countdown für Wiederverbindungsversuche.
![Die trivago-Offlineseite mit dem trivago Offlinelabyrinth](https://web.developers.google.cn/static/articles/offline-fallback-page/image/the-trivago-offline-page-e71a8ba43ac2c.png?authuser=6&hl=de)
Service Worker registrieren
Dazu verwenden Sie einen Service Worker. Sie können einen Service Worker wie im folgenden Codebeispiel auf Ihrer Hauptseite registrieren. Normalerweise tun Sie das, sobald Ihre 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 folgenden Beispiel sollten der Sache verdeutlichen. Die Kernidee besteht darin, eine Datei namens offline.html
, die nur bei fehlerhaften Navigationsanfragen bereitgestellt wird, vorab im Cache zu speichern. Alle anderen Fälle sollen dann vom Browser verarbeitet werden:
/*
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 Seite „Offline-Fallback“
In der Datei offline.html
kannst du deiner Kreativität freien Lauf lassen, sie an deine Anforderungen anpassen und dein Branding hinzufügen. Das folgende Beispiel zeigt das Minimum dessen, was möglich ist.
Sie zeigt sowohl das manuelle Aktualisieren nach Betätigen einer Schaltfläche als auch die automatische Aktualisierung basierend auf dem online
-Ereignis und regulären Serverabfragen.
<!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 du Interesse hast, kannst du den Quellcode auf Glitch erkunden.
Hinweis zur Installation deiner App
Da Ihre Website jetzt eine Offline-Fallback-Seite hat, möchten Sie vielleicht wissen, welche Schritte als Nächstes zu tun sind. Damit Ihre App installierbar wird, müssen Sie ein Web-App-Manifest hinzufügen und optional eine Installationsstrategie festlegen.
Hinweis zum Bereitstellen einer Offline-Fallback-Seite mit Workbox.js
Vielleicht haben Sie schon von Workbox gehört. Workbox besteht aus einer Reihe von JavaScript-Bibliotheken, mit denen Webanwendungen Offline-Unterstützung hinzugefügt werden können. Wenn Sie lieber selbst weniger Service Worker-Code schreiben möchten, können Sie das Workbox-Rezept nur für eine Offlineseite verwenden.
Als Nächstes erfahren Sie, wie Sie eine Installationsstrategie für Ihre App definieren.