Skip to content

Události ​

Balíček posílá běžné Laravel události (Illuminate\Foundation\Events\Dispatchable). Poslouchat je můžete v AppServiceProvider::boot() přes Event::listen() nebo v listenerech s automatickým objevováním. Všechny jsou ve jmenném prostoru NyonCode\LaravelPwa\Events.

UdálostKdyData
ManifestResolvingkaždý požadavek na manifest, po resolverech$request, $manifest (kopie pro tento požadavek, smíte ji měnit)
ServiceWorkerBuiltpwa:build zapsal service worker$version, $path, $precache
KillSwitchActivatedpwa:disable / Pwa::disable()–
KillSwitchDeactivatedpwa:enable / Pwa::enable()–
TelemetryReceivedSW nebo klient nahlásil chyby (POST /pwa/telemetry)$source (sw, client), $events, $userAgent
PushSubscribedprohlížeč uložil nebo obnovil push odběr$subscription
PushUnsubscribedodběr byl odebrán (odhlášení odběru, odhlášení, limit zařízení)$subscription
PushSubscriptionExpiredpush služba odpověděla 404/410; odběr byl smazán$subscription, $report
PushFaileddoručení selhalo jinak (413, 429, 5xx, síť, nepovolený endpoint)$subscription, $report

Režim údržby (pwa:down) volá artisan down, takže platí Laravel události Illuminate\Foundation\Events\MaintenanceModeEnabled a MaintenanceModeDisabled.

Příklady ​

Úprava manifestu ​

php
use NyonCode\LaravelPwa\Events\ManifestResolving;

Event::listen(function (ManifestResolving $event) {
    if (now()->month === 12) {
        $event->manifest->themeColor('#b91c1c');
    }
});

Pro tenanty a jazyky je lepší resolver: umí si předat parametry z vykreslené stránky. Událost se hodí pro drobné globální úpravy.

Po sestavení service workeru ​

php
use NyonCode\LaravelPwa\Events\ServiceWorkerBuilt;

Event::listen(function (ServiceWorkerBuilt $event) {
    Http::post(config('services.cdn.purge_url'), ['paths' => ['/sw.js']]);
    Log::info("PWA {$event->version}: ".count($event->precache).' souborů v precache');
});

Nouzové vypnutí ​

php
use NyonCode\LaravelPwa\Events\KillSwitchActivated;

Event::listen(fn (KillSwitchActivated $event) => Notification::route('slack', config('services.slack.ops'))
    ->notify(new PwaKillSwitchUsed()));

Telemetrie do Sentry ​

php
use NyonCode\LaravelPwa\Events\TelemetryReceived;

Event::listen(function (TelemetryReceived $event) {
    foreach ($event->events as $error) {
        \Sentry\captureMessage("[pwa:{$event->source}] {$error['type']}: {$error['message']}");
    }
});

Balíček události ve výchozím stavu zapisuje do logu (listener LogTelemetry, kanál telemetry.channel). Pokud je zpracováváte sami, vypněte to: 'telemetry' => ['log' => false]. Události obsahují jen technická data (typ, zpráva, stack, verze SW, režim zobrazení, User-Agent), žádné osobní údaje.

Testování ​

php
Event::fake([ServiceWorkerBuilt::class]);

$this->artisan('pwa:build')->assertSuccessful();

Event::assertDispatched(ServiceWorkerBuilt::class, fn ($event) => $event->precache !== []);

Released under the MIT License.