Skip to content

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í ​

  1. Zvýší počítadlo návštěv (localStorage pwa:visits).
  2. Nastaví cookie pwa_display s režimem zobrazení.
  3. Obalí fetch a window.axios pro opakování po 419 (s session.refresh_csrf, jen požadavky na vlastní origin).
  4. Zapne adaptéry Livewire a Inertia.
  5. Zaregistruje service worker, nebo ho odregistruje (enabled: false).
  6. Spustí keep-alive interval.
  7. Vyšle pwa:ready.

window.Pwa ​

ČlenVracíPopis
configobjectkonfigurace z #pwa-config
displayMode()stringwindow-controls-overlay, tabbed, fullscreen, standalone, minimal-ui, browser
isInstalled()booldisplayMode() !== 'browser' (na iOS i navigator.standalone)
isIos()booliPhone, 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()Promiseruč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)functionposluchač bez prefixu pwa:; vrací funkci pro odhlášení
badge.set(n)PromiseBadging API (iOS 16.4+, Android, desktop)
badge.clear()Promise
push.*supported(), permission(), state(), subscribe(), unsubscribe(), subscription(); viz Push notifikace
js
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álostdetailKdy
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
js
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íč localStorageObsah
pwa:visitspočet návštěv
pwa:install-dismissedčas odmítnutí instalace
pwa:warmhash uživatele a čas posledního předehřátí
pwa:pushendpoint, 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í.

Released under the MIT License.