Что общего между приложением Google Assistant, приложением Slack, приложением Zoom и практически любым другим приложением для конкретной платформы на вашем телефоне или компьютере? Да, они всегда хоть что-то дают. Даже если у вас нет подключения к сети, вы все равно можете открыть приложение Assistant, войти в Slack или запустить Zoom. Возможно, вы не получите ничего особенно значимого или даже не сможете достичь того, чего хотели, но, по крайней мере, вы что-то получите, и приложение будет контролировать ситуацию.
![Мобильное приложение Google Assistant в автономном режиме.](https://web.dev/static/articles/offline-fallback-page/image/google-assistant-mobile-a-c1c796df5fae3.jpg?authuser=5&hl=ru)
Напротив, в Интернете традиционно вы ничего не получаете, находясь в автономном режиме. Chrome предоставляет вам офлайн-игру с динозаврами , но это все.
![Мобильное приложение Google Chrome, показывающее офлайн-игру с динозаврами.](https://web.dev/static/articles/offline-fallback-page/image/google-chrome-mobile-app-2434801002fc9.png?authuser=5&hl=ru)
Автономная резервная страница с пользовательским сервисным работником
Однако так не должно быть. Благодаря сервисным работникам и API Cache Storage вы можете предоставить своим пользователям индивидуальный режим работы в автономном режиме. Это может быть простая фирменная страница с информацией о том, что пользователь в данный момент не в сети, но может быть и более креативное решение, как, например, знаменитая оффлайн-игра-лабиринт trivago с ручной кнопкой Reconnect и автоматической попыткой переподключения. обратный отсчет.
![Оффлайн-страница trivago с офлайн-лабиринтом trivago.](https://web.dev/static/articles/offline-fallback-page/image/the-trivago-offline-page-e71a8ba43ac2c.png?authuser=5&hl=ru)
Регистрация сервис-воркера
Это можно сделать через сервисного работника. Вы можете зарегистрировать сервис-воркера со своей главной страницы, как показано в примере кода ниже. Обычно вы делаете это после загрузки приложения.
window.addEventListener("load", () => {
if ("serviceWorker" in navigator) {
navigator.serviceWorker.register("service-worker.js");
}
});
Код сервисного работника
Содержимое файла сервис-воркера на первый взгляд может показаться немного запутанным, но комментарии в примере ниже должны прояснить ситуацию. Основная идея состоит в том, чтобы предварительно кэшировать файл с именем offline.html
, который будет обслуживаться только при неудачных навигационных запросах, и позволить браузеру обрабатывать все остальные случаи:
/*
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.
});
Резервная офлайн-страница
В файле offline.html
вы можете проявить творческий подход, адаптировать его к своим потребностям и добавить свой фирменный стиль. Пример ниже показывает минимум того, что возможно. Он демонстрирует как ручную перезагрузку по нажатию кнопки, так и автоматическую перезагрузку на основе online
события и обычного опроса сервера.
<!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>
Демо
Вы можете увидеть резервную страницу автономного режима в действии в демо- версии, представленной ниже. Если вам интересно, вы можете изучить исходный код на Glitch.
Примечание о том, как сделать приложение доступным для установки.
Теперь, когда на вашем сайте есть запасная автономная страница, вы можете задаться вопросом о следующих шагах. Чтобы сделать ваше приложение доступным для установки, вам необходимо добавить манифест веб-приложения и, при необходимости, разработать стратегию установки .
Примечание по обслуживанию автономной резервной страницы с помощью Workbox.js.
Возможно, вы слышали о Workbox . Workbox — это набор библиотек JavaScript для добавления автономной поддержки в веб-приложения. Если вы предпочитаете писать меньше кода сервис-воркера самостоятельно, вы можете использовать рецепт Workbox только для автономной страницы .
Далее вы узнаете, как определить стратегию установки вашего приложения.