JavaScript klient
/pwa/client.js načte <x-pwa::head/> jako ES modul. Nemá závislosti a nepotřebuje build.
Co dělá po načtení
- Zvýší počítadlo návštěv (localStorage
pwa:visits). - Nastaví cookie
pwa_displays režimem zobrazení. - Obalí
fetchawindow.axiospro opakování po 419 (ssession.refresh_csrf, jen požadavky na vlastní origin). - Zapne adaptéry Livewire a Inertia.
- Zaregistruje service worker, nebo ho odregistruje (
enabled: false). - Spustí keep-alive interval.
- Vyšle
pwa:ready.
window.Pwa
| Člen | Vrací | Popis |
|---|---|---|
config | object | konfigurace z #pwa-config |
displayMode() | string | window-controls-overlay, tabbed, fullscreen, standalone, minimal-ui, browser |
isInstalled() | bool | displayMode() !== 'browser' (na iOS i navigator.standalone) |
isIos() | bool | iPhone, iPod, iPad (i iPad hlásící se jako Mac) |
install() | Promise<string> | accepted, dismissed, unavailable; použije navigator.install() nebo uloženou výzvu |
update() | Promise | ručně zkontroluje novou verzi SW |
keepAlive() | Promise<object|null> | zavolá /pwa/session hned |
warm() | Promise<object|null> | stáhne stránky k předehřátí hned; {count, skipped, failed} (Offline) |
version() | Promise<string|null> | verze aktivního SW |
on(event, fn) | function | posluchač bez prefixu pwa:; vrací funkci pro odhlášení |
badge.set(n) | Promise | Badging API (iOS 16.4+, Android, desktop) |
badge.clear() | Promise | |
push.* | supported(), permission(), state(), subscribe(), unsubscribe(), subscription(); viz Push notifikace |
if (!Pwa.isInstalled() && Pwa.isIos()) showIosHelp()
const off = Pwa.on('queue', ({ count }) => (queueBadge.textContent = count || ''))
Pwa.badge.set(unreadCount)
console.log(await Pwa.version())Události
Všechny jako CustomEvent na document (pwa:jméno) i přes Pwa.on('jméno').
| Událost | detail | Kdy |
|---|---|---|
pwa:ready | {displayMode} | klient načten |
pwa:resume | {displayMode} | návrat do aplikace (viditelnost, bfcache) |
pwa:online | {} | obnovení připojení |
pwa:offline | {} | SW nezvládl navigaci ani akci kvůli síti |
pwa:maintenance | {retryAfter} | SW dostal 503 |
pwa:logout | {} | SW zpracoval odhlášení |
pwa:queue | {count} | změna fronty offline akcí |
pwa:replayed | {url, status} | akce z fronty odeslána |
pwa:update-available | {worker} | čeká nová verze SW |
pwa:activated | {version} | aktivovala se verze SW |
pwa:installed | {} | appinstalled |
pwa:csrf | {token} | nový CSRF token propsán |
pwa:csrf-refreshed | {} | Livewire 419 vyřešeno |
pwa:identity | {user} | přihlásil se jiný uživatel (hash) |
pwa:warmed | {count, skipped, failed} | předehřátí skončilo |
pwa:push | {state, lost?, error?} | push odběr se změnil (subscribed, unsubscribed, denied) |
pwa:push-received | {tag} | worker zobrazil push notifikaci |
pwa:push-renewed | {} | worker obnovil vyměněný odběr |
pwa:notification-click | {url, action} | uživatel klikl na notifikaci |
document.addEventListener('pwa:resume', () => refreshDashboard())
document.addEventListener('pwa:logout', () => pushSystem.unsubscribe())Lišta
Pro offline, údržbu, frontu a aktualizaci klient ukáže malou lištu dole (.pwa-bar, role=status, aria-live=polite, respektuje safe-area). Texty z pwa::messages. Styl se nastavuje přes element.style (CSP-safe). Vlastní UI: lištu skryjte (.pwa-bar { display: none !important }) a reagujte na události.
Aktualizace service workeru
Nová verze čeká; lišta nabídne „Načíst“. Po kliknutí klient pošle SKIP_WAITING a po controllerchange stránku znovu načte. Bez kliknutí se nová verze aktivuje, až se zavřou všechna okna aplikace. Vlastní UI: pwa:update-available a detail.worker.postMessage({type: 'SKIP_WAITING'}).
Úložiště
| Klíč localStorage | Obsah |
|---|---|
pwa:visits | počet návštěv |
pwa:install-dismissed | čas odmítnutí instalace |
pwa:warm | hash uživatele a čas posledního předehřátí |
pwa:push | endpoint, hash uživatele a čas posledního potvrzení push odběru tohoto prohlížeče |
Přístup je v try/catch (soukromý režim, plné úložiště). Přihlášení na localStorage nikdy nezávisí.