Quel est le point commun entre l'application Assistant Google, l'application Slack, l'application Zoom et presque toutes les autres applications spécifiques à la plate-forme sur votre téléphone ou votre ordinateur ? Oui, ils vous donnent toujours quelque chose. Même lorsque vous n'avez pas de connexion réseau, vous pouvez toujours ouvrir l'application Assistant, accéder à Slack ou lancer Zoom. Il est possible que vous n'obteniez rien de particulièrement significatif ou que vous ne puissiez pas réaliser ce que vous vouliez, mais au moins vous obteniez quelque chose et l'application en garde le contrôle.
![Application mobile Assistant Google hors connexion.](https://web.dev/static/articles/offline-fallback-page/image/google-assistant-mobile-a-c1c796df5fae3.jpg?authuser=6&hl=fr)
![Application mobile Slack hors connexion.](https://web.dev/static/articles/offline-fallback-page/image/slack-mobile-app-while-of-62be23091324d.jpg?authuser=6&hl=fr)
![Application mobile Zoom hors connexion.](https://web.dev/static/articles/offline-fallback-page/image/zoom-mobile-app-while-off-02f0aa84f73c7.jpg?authuser=6&hl=fr)
En revanche, sur le Web, vous n'avez généralement rien quand vous êtes hors connexion. Chrome propose un jeu du dinosaure hors connexion, mais c'est tout.
![Application mobile Google Chrome affichant le jeu du dinosaure hors connexion](https://web.dev/static/articles/offline-fallback-page/image/google-chrome-mobile-app-2434801002fc9.png?authuser=6&hl=fr)
![Application de bureau Google Chrome affichant le jeu du dinosaure hors connexion](https://web.dev/static/articles/offline-fallback-page/image/google-chrome-desktop-app-986e96e382e5b.png?authuser=6&hl=fr)
Page de remplacement hors connexion avec un service worker personnalisé
Ce n'est toutefois pas systématiquement le cas. Grâce aux service workers et à l'API Cache Storage, vous pouvez offrir une expérience hors connexion personnalisée à vos utilisateurs. Il peut s'agir d'une simple page associée à la marque qui indique que l'utilisateur est actuellement hors connexion, mais il peut aussi s'agir d'une solution plus créative, comme le célèbre jeu de labyrinthe hors connexion de trivago, avec un bouton Reconnecter manuel et un compte à rebours pour les tentatives de reconnexion automatique.
![La page hors connexion de trivago et le labyrinthe hors connexion de trivago](https://web.dev/static/articles/offline-fallback-page/image/the-trivago-offline-page-e71a8ba43ac2c.png?authuser=6&hl=fr)
Enregistrer le service worker
Pour cela, vous devez passer par un service worker. Vous pouvez enregistrer un service worker depuis votre page principale, comme dans l'exemple de code ci-dessous. En général, vous le faites une fois l'application chargée.
window.addEventListener("load", () => {
if ("serviceWorker" in navigator) {
navigator.serviceWorker.register("service-worker.js");
}
});
Le code du service worker
Le contenu du fichier de service worker réel peut sembler un peu complexe à première vue, mais les commentaires de l'exemple ci-dessous devraient clarifier la situation. L'idée principale est de mettre en pré-cache un fichier nommé offline.html
qui n'est diffusé qu'en cas d'échec des requêtes de navigation et de laisser le navigateur gérer tous les autres cas:
/*
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.
});
Page de remplacement hors connexion
Le fichier offline.html
vous permet de laisser libre cours à votre créativité, de l'adapter à vos besoins et d'ajouter votre marque. L'exemple ci-dessous montre le strict minimum.
Elle illustre l'actualisation manuelle en appuyant sur un bouton, ainsi que l'actualisation automatique basée sur l'événement online
et l'interrogation standard du serveur.
<!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>
Démonstration
Vous pouvez voir la page de remplacement hors connexion en action dans la démonstration intégrée ci-dessous. Si cela vous intéresse, vous pouvez explorer le code source sur Glitch.
Remarque concernant la possibilité d'installer votre application
Maintenant que votre site dispose d'une page de remplacement hors connexion, vous vous demandez peut-être quelles sont les étapes suivantes. Pour rendre votre application installable, vous devez ajouter un fichier manifeste d'application Web et éventuellement proposer une stratégie d'installation.
Remarque sur la diffusion d'une page de remplacement hors connexion avec Workbox.js
Vous avez peut-être déjà entendu parler de Workbox. Workbox est un ensemble de bibliothèques JavaScript permettant d'utiliser les applications Web hors connexion. Si vous préférez écrire moins de code de service worker vous-même, vous pouvez utiliser la recette Workbox pour une page hors connexion uniquement.
Dans la suite, découvrez comment définir une stratégie d'installation pour votre application.