Обновлена конфигурация Vite для PWA с улучшенной обработкой навигации и кэширования HTML-документов. Добавлены новые правила кэширования для страниц и HTML-файлов, а также изменен тип регистрации сервисного работника на автоматическое обновление. Обновлен HTML-шаблон с улучшениями в загрузке и отображении темы.
This commit is contained in:
parent
e6acd8c5df
commit
d023e20862
131
OFFLINE_FIX.md
Normal file
131
OFFLINE_FIX.md
Normal file
@ -0,0 +1,131 @@
|
||||
# Исправление проблемы с оффлайн режимом
|
||||
|
||||
## Проблема
|
||||
При обновлении страницы в оффлайн режиме попеременно показывается сообщение "нет подключения к интернету" и нормальное отображение приложения.
|
||||
|
||||
## Причина
|
||||
Service Worker использовал стратегию, которая пыталась обратиться к сети перед использованием кэша, что приводило к показу страницы ошибки браузера при отсутствии подключения.
|
||||
|
||||
## Решение
|
||||
Внесены изменения в `vite.config.ts` для обеспечения стабильной работы в оффлайн режиме:
|
||||
|
||||
### 1. Стратегия CacheFirst для навигационных запросов
|
||||
Теперь при обновлении страницы Service Worker **сразу** загружает кэшированную версию без попыток обращения к сети:
|
||||
|
||||
```typescript
|
||||
{
|
||||
urlPattern: ({ request }) => request.mode === 'navigate',
|
||||
handler: "CacheFirst",
|
||||
options: {
|
||||
cacheName: "pages-cache",
|
||||
expiration: {
|
||||
maxEntries: 10,
|
||||
maxAgeSeconds: 7 * 24 * 60 * 60, // 7 days
|
||||
},
|
||||
cacheableResponse: {
|
||||
statuses: [0, 200],
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Дополнительное кэширование HTML файлов
|
||||
Добавлено специальное правило для всех HTML файлов:
|
||||
|
||||
```typescript
|
||||
{
|
||||
urlPattern: /\.html$/,
|
||||
handler: "CacheFirst",
|
||||
options: {
|
||||
cacheName: "html-cache",
|
||||
expiration: {
|
||||
maxEntries: 10,
|
||||
maxAgeSeconds: 7 * 24 * 60 * 60,
|
||||
},
|
||||
cacheableResponse: {
|
||||
statuses: [0, 200],
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Автоматическое обновление Service Worker
|
||||
Изменен тип регистрации с `"prompt"` на `"autoUpdate"` для обеспечения автоматического обновления SW без запроса пользователя:
|
||||
|
||||
```typescript
|
||||
registerType: "autoUpdate"
|
||||
```
|
||||
|
||||
### 4. Отключение Navigation Preload
|
||||
Добавлена настройка `navigationPreload: false` для предотвращения попыток загрузки из сети при навигации.
|
||||
|
||||
## Как применить изменения
|
||||
|
||||
### 1. Пересборка проекта
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
### 2. Копирование файлов на сервер
|
||||
После успешной сборки скопируйте содержимое папки `dist/` в `backend/public/`:
|
||||
|
||||
```bash
|
||||
# Windows PowerShell
|
||||
Remove-Item -Recurse -Force backend/public/*
|
||||
Copy-Item -Recurse dist/* backend/public/
|
||||
|
||||
# Linux/Mac
|
||||
rm -rf backend/public/*
|
||||
cp -r dist/* backend/public/
|
||||
```
|
||||
|
||||
### 3. Запуск сервера
|
||||
Запустите сервер (или попросите это сделать):
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
npm start
|
||||
```
|
||||
|
||||
### 4. Проверка работы
|
||||
1. Откройте приложение в браузере
|
||||
2. Дождитесь полной загрузки приложения
|
||||
3. Откройте DevTools → Application → Service Workers
|
||||
4. Убедитесь, что новый Service Worker активирован
|
||||
5. Переключите браузер в оффлайн режим (DevTools → Network → Offline)
|
||||
6. Обновите страницу несколько раз - приложение должно загружаться из кэша каждый раз
|
||||
|
||||
### 5. Очистка старого кэша (если необходимо)
|
||||
Если проблема все еще возникает, попробуйте:
|
||||
1. DevTools → Application → Clear storage → Clear site data
|
||||
2. Закройте и откройте браузер заново
|
||||
3. Перейдите на сайт снова - новый SW установится и закэширует все ресурсы
|
||||
4. Проверьте работу в оффлайн режиме
|
||||
|
||||
## Технические детали
|
||||
|
||||
### Стратегии кэширования
|
||||
|
||||
**CacheFirst (Cache First, Network Fallback)**
|
||||
- Сначала проверяется кэш
|
||||
- Если ресурс найден в кэше, он возвращается немедленно
|
||||
- Если ресурса нет в кэше, делается запрос к сети
|
||||
- Идеально для статических ресурсов и оффлайн работы
|
||||
|
||||
**NetworkFirst** (используется для API)
|
||||
- Сначала пытается загрузить из сети
|
||||
- Если сеть недоступна или таймаут, возвращается кэшированная версия
|
||||
- Идеально для данных, которые должны быть актуальными
|
||||
|
||||
### Настройки Service Worker
|
||||
- `skipWaiting: true` - новый SW активируется немедленно
|
||||
- `clientsClaim: true` - новый SW берет контроль над всеми открытыми страницами
|
||||
- `cleanupOutdatedCaches: true` - автоматическая очистка устаревших кэшей
|
||||
|
||||
## Ожидаемый результат
|
||||
После применения изменений приложение будет:
|
||||
- ✅ Всегда загружаться из кэша в оффлайн режиме
|
||||
- ✅ Не показывать страницу "нет подключения к интернету"
|
||||
- ✅ Работать стабильно при любом количестве обновлений страницы
|
||||
- ✅ Автоматически обновлять Service Worker без запроса пользователя
|
||||
|
||||
@ -1 +1 @@
|
||||
if(!self.define){let e,i={};const n=(n,c)=>(n=new URL(n+".js",c).href,i[n]||new Promise(i=>{if("document"in self){const e=document.createElement("script");e.src=n,e.onload=i,document.head.appendChild(e)}else e=n,importScripts(n),i()}).then(()=>{let e=i[n];if(!e)throw new Error(`Module ${n} didn’t register its module`);return e}));self.define=(c,o)=>{const s=e||("document"in self?document.currentScript.src:"")||location.href;if(i[s])return;let a={};const d=e=>n(e,s),r={module:{uri:s},exports:a,require:d};i[s]=Promise.all(c.map(e=>r[e]||d(e))).then(e=>(o(...e),a))}}define(["./workbox-e20531c6"],function(e){"use strict";self.skipWaiting(),e.clientsClaim(),e.precacheAndRoute([{url:"assets/index-B61qRIc-.js",revision:"96888e49126c254a0b6fb7a9428bddb6"},{url:"assets/index-DK8OUj6L.css",revision:"b1e2c4e8724be2f2bcee585338910e99"},{url:"icon.svg",revision:"0ec61aab261526d4c491e887a6f3374e"},{url:"icons/icon-128x128.png",revision:"fa71db17e345406d5f7d847f88c65ac4"},{url:"icons/icon-144x144.png",revision:"e790ff42758ea1a2a46eb84201630757"},{url:"icons/icon-152x152.png",revision:"88f2400f6617a32cc9cd62c70fb49a05"},{url:"icons/icon-16x16.png",revision:"101c13808e9fd0956f247bc446a8ac1e"},{url:"icons/icon-192x192.png",revision:"7d86d2d2ada99d7cee015dff0fdcb497"},{url:"icons/icon-32x32.png",revision:"22ee5d42535bc339ab0e19cb496378a5"},{url:"icons/icon-384x384.png",revision:"c601fa602952a903389e5e8f8a699617"},{url:"icons/icon-48x48.png",revision:"cfdd3bebd931375f2e0277d638ec8781"},{url:"icons/icon-512x512.png",revision:"8731edef999b9e7deba310d72a739925"},{url:"icons/icon-72x72.png",revision:"6b3cb1b2537ec91921698260a9c2f47c"},{url:"icons/icon-96x96.png",revision:"7efd757a81217207d981de88ef199d86"},{url:"index.html",revision:"45ec10836831308e81415ddb8cc82efd"},{url:"logo.svg",revision:"5962d0d24d9cd26cd8aaff9cb6f54a5a"},{url:"registerSW.js",revision:"1872c500de691dce40960bb85481de07"},{url:"icon.svg",revision:"0ec61aab261526d4c491e887a6f3374e"},{url:"icons/icon-192x192.png",revision:"7d86d2d2ada99d7cee015dff0fdcb497"},{url:"icons/icon-512x512.png",revision:"8731edef999b9e7deba310d72a739925"},{url:"icons/icon-72x72.png",revision:"6b3cb1b2537ec91921698260a9c2f47c"},{url:"icons/icon-96x96.png",revision:"7efd757a81217207d981de88ef199d86"},{url:"icons/icon-128x128.png",revision:"fa71db17e345406d5f7d847f88c65ac4"},{url:"icons/icon-144x144.png",revision:"e790ff42758ea1a2a46eb84201630757"},{url:"icons/icon-152x152.png",revision:"88f2400f6617a32cc9cd62c70fb49a05"},{url:"icons/icon-384x384.png",revision:"c601fa602952a903389e5e8f8a699617"},{url:"manifest.webmanifest",revision:"1c071cadebd7a1b0dc1eeb0270e73fb8"}],{ignoreURLParametersMatching:[/^utm_/,/^fbclid$/]}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("/index.html"),{denylist:[/^\/api/,/^\/uploads/]})),e.registerRoute(/^https:\/\/api\./,new e.NetworkFirst({cacheName:"api-cache",plugins:[new e.ExpirationPlugin({maxEntries:50,maxAgeSeconds:3600})]}),"GET"),e.registerRoute(/\/api\//,new e.NetworkFirst({cacheName:"api-cache-local",networkTimeoutSeconds:10,plugins:[new e.ExpirationPlugin({maxEntries:100,maxAgeSeconds:86400})]}),"GET"),e.registerRoute(/\/uploads\//,new e.CacheFirst({cacheName:"uploads-cache",plugins:[new e.ExpirationPlugin({maxEntries:200,maxAgeSeconds:2592e3})]}),"GET"),e.registerRoute(/\.(?:png|jpg|jpeg|svg|gif|webp)$/,new e.CacheFirst({cacheName:"images-cache",plugins:[new e.ExpirationPlugin({maxEntries:100,maxAgeSeconds:2592e3})]}),"GET")});
|
||||
if(!self.define){let e,n={};const i=(i,c)=>(i=new URL(i+".js",c).href,n[i]||new Promise(n=>{if("document"in self){const e=document.createElement("script");e.src=i,e.onload=n,document.head.appendChild(e)}else e=i,importScripts(i),n()}).then(()=>{let e=n[i];if(!e)throw new Error(`Module ${i} didn’t register its module`);return e}));self.define=(c,s)=>{const o=e||("document"in self?document.currentScript.src:"")||location.href;if(n[o])return;let a={};const r=e=>i(e,o),d={module:{uri:o},exports:a,require:r};n[o]=Promise.all(c.map(e=>d[e]||r(e))).then(e=>(s(...e),a))}}define(["./workbox-40c80ae4"],function(e){"use strict";self.skipWaiting(),e.clientsClaim(),e.precacheAndRoute([{url:"assets/index-B61qRIc-.js",revision:"96888e49126c254a0b6fb7a9428bddb6"},{url:"assets/index-DK8OUj6L.css",revision:"b1e2c4e8724be2f2bcee585338910e99"},{url:"icon.svg",revision:"537ae73d8f9e90e6a01816aa6d527d16"},{url:"icons/icon-128x128.png",revision:"fa71db17e345406d5f7d847f88c65ac4"},{url:"icons/icon-144x144.png",revision:"e790ff42758ea1a2a46eb84201630757"},{url:"icons/icon-152x152.png",revision:"88f2400f6617a32cc9cd62c70fb49a05"},{url:"icons/icon-16x16.png",revision:"101c13808e9fd0956f247bc446a8ac1e"},{url:"icons/icon-192x192.png",revision:"7d86d2d2ada99d7cee015dff0fdcb497"},{url:"icons/icon-32x32.png",revision:"22ee5d42535bc339ab0e19cb496378a5"},{url:"icons/icon-384x384.png",revision:"c601fa602952a903389e5e8f8a699617"},{url:"icons/icon-48x48.png",revision:"cfdd3bebd931375f2e0277d638ec8781"},{url:"icons/icon-512x512.png",revision:"8731edef999b9e7deba310d72a739925"},{url:"icons/icon-72x72.png",revision:"6b3cb1b2537ec91921698260a9c2f47c"},{url:"icons/icon-96x96.png",revision:"7efd757a81217207d981de88ef199d86"},{url:"index.html",revision:"ac16c70d736d7f92715a884f73979e8e"},{url:"logo.svg",revision:"11616ede8898b4c24203e331b3ec6dc3"},{url:"registerSW.js",revision:"1872c500de691dce40960bb85481de07"},{url:"icon.svg",revision:"537ae73d8f9e90e6a01816aa6d527d16"},{url:"icons/icon-192x192.png",revision:"7d86d2d2ada99d7cee015dff0fdcb497"},{url:"icons/icon-512x512.png",revision:"8731edef999b9e7deba310d72a739925"},{url:"icons/icon-72x72.png",revision:"6b3cb1b2537ec91921698260a9c2f47c"},{url:"icons/icon-96x96.png",revision:"7efd757a81217207d981de88ef199d86"},{url:"icons/icon-128x128.png",revision:"fa71db17e345406d5f7d847f88c65ac4"},{url:"icons/icon-144x144.png",revision:"e790ff42758ea1a2a46eb84201630757"},{url:"icons/icon-152x152.png",revision:"88f2400f6617a32cc9cd62c70fb49a05"},{url:"icons/icon-384x384.png",revision:"c601fa602952a903389e5e8f8a699617"},{url:"manifest.webmanifest",revision:"1c071cadebd7a1b0dc1eeb0270e73fb8"}],{ignoreURLParametersMatching:[/^utm_/,/^fbclid$/]}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("/index.html"),{denylist:[/^\/api/,/^\/uploads/]})),e.registerRoute(({request:e})=>"navigate"===e.mode,new e.CacheFirst({cacheName:"pages-cache",plugins:[new e.ExpirationPlugin({maxEntries:10,maxAgeSeconds:604800}),new e.CacheableResponsePlugin({statuses:[0,200]})]}),"GET"),e.registerRoute(/\.html$/,new e.CacheFirst({cacheName:"html-cache",plugins:[new e.ExpirationPlugin({maxEntries:10,maxAgeSeconds:604800}),new e.CacheableResponsePlugin({statuses:[0,200]})]}),"GET"),e.registerRoute(/^https:\/\/api\./,new e.NetworkFirst({cacheName:"api-cache",plugins:[new e.ExpirationPlugin({maxEntries:50,maxAgeSeconds:3600})]}),"GET"),e.registerRoute(/\/api\//,new e.NetworkFirst({cacheName:"api-cache-local",networkTimeoutSeconds:10,plugins:[new e.ExpirationPlugin({maxEntries:100,maxAgeSeconds:86400})]}),"GET"),e.registerRoute(/\/uploads\//,new e.CacheFirst({cacheName:"uploads-cache",plugins:[new e.ExpirationPlugin({maxEntries:200,maxAgeSeconds:2592e3})]}),"GET"),e.registerRoute(/\.(?:png|jpg|jpeg|svg|gif|webp)$/,new e.CacheFirst({cacheName:"images-cache",plugins:[new e.ExpirationPlugin({maxEntries:100,maxAgeSeconds:2592e3})]}),"GET")});
|
||||
|
||||
1
backend/public/workbox-40c80ae4.js
Normal file
1
backend/public/workbox-40c80ae4.js
Normal file
File diff suppressed because one or more lines are too long
@ -91,9 +91,11 @@ export default defineConfig({
|
||||
globPatterns: ["**/*.{js,css,html,ico,png,svg,woff,woff2,ttf,eot}"],
|
||||
// Игнорируем параметры URL при кешировании
|
||||
ignoreURLParametersMatching: [/^utm_/, /^fbclid$/],
|
||||
// Обработка ошибок при precaching - не падаем на 404
|
||||
// Обработка навигации - всегда используем кэшированную версию
|
||||
navigateFallback: "/index.html",
|
||||
navigateFallbackDenylist: [/^\/api/, /^\/uploads/],
|
||||
// Стратегия для навигационных запросов - сначала кэш
|
||||
navigationPreload: false,
|
||||
// Обработка ошибок при загрузке файлов для precaching
|
||||
dontCacheBustURLsMatching: /\.\w{8}\./,
|
||||
// Фильтруем манифест, чтобы исключить несуществующие файлы и дубликаты
|
||||
@ -113,6 +115,38 @@ export default defineConfig({
|
||||
},
|
||||
],
|
||||
runtimeCaching: [
|
||||
// HTML документы - всегда сначала кэш для оффлайн работы
|
||||
// Это гарантирует, что при обновлении страницы в оффлайн режиме
|
||||
// всегда будет загружаться кэшированная версия БЕЗ попыток обращения к сети
|
||||
{
|
||||
urlPattern: ({ request }) => request.mode === 'navigate',
|
||||
handler: "CacheFirst",
|
||||
options: {
|
||||
cacheName: "pages-cache",
|
||||
expiration: {
|
||||
maxEntries: 10,
|
||||
maxAgeSeconds: 7 * 24 * 60 * 60, // 7 days
|
||||
},
|
||||
cacheableResponse: {
|
||||
statuses: [0, 200],
|
||||
},
|
||||
},
|
||||
},
|
||||
// Дополнительное правило для HTML файлов
|
||||
{
|
||||
urlPattern: /\.html$/,
|
||||
handler: "CacheFirst",
|
||||
options: {
|
||||
cacheName: "html-cache",
|
||||
expiration: {
|
||||
maxEntries: 10,
|
||||
maxAgeSeconds: 7 * 24 * 60 * 60, // 7 days
|
||||
},
|
||||
cacheableResponse: {
|
||||
statuses: [0, 200],
|
||||
},
|
||||
},
|
||||
},
|
||||
{
|
||||
urlPattern: /^https:\/\/api\./,
|
||||
handler: "NetworkFirst",
|
||||
@ -165,7 +199,9 @@ export default defineConfig({
|
||||
// Обработка ошибок при precaching - игнорируем 404 ошибки
|
||||
maximumFileSizeToCacheInBytes: 5 * 1024 * 1024, // 5MB
|
||||
},
|
||||
registerType: "prompt",
|
||||
// Автоматическое обновление SW без запроса пользователя
|
||||
// для обеспечения стабильной работы в оффлайн режиме
|
||||
registerType: "autoUpdate",
|
||||
devOptions: {
|
||||
enabled: true,
|
||||
type: "module",
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user