ServiceWorker

Propriétés

L'interface ServiceWorker hérite des propriétés de son parent, le Worker.

ServiceWorker.scriptURL Lecture seule

Retourne l'url sérialisée du ServiceWorker, définie comme étant partie du ServiceWorkerRegistration. Cette URL doit être de la même origine que le document qui enregistre le  ServiceWorker.

ServiceWorker.state Lecture seule

Retourne le status du service worker. Il retourne l'une des valeurs suivantes : installing, installed, activating, activated, or redundant.

Gestionnaires d'évènements

ServiceWorker.onstatechange Lecture seule

Une propriété EventListener est appelé quand un évenement de type statechange est déclenché; c'est le cas dès que le  ServiceWorker.state change.

Méthodes

L'interface du ServiceWorker hérite des méthodes de son parent, Worker, avec l'exception de Worker.terminate, qui ne doit pas être accessible depuis le service worker.

Exemples

Ce fragment de code présente un exemple d'enregistrement d'évenement pour le service worker (démo live). Le code écoute pour tout changement du ServiceWorker.state et retourne sa valeur.

if ('serviceWorker' in navigator) {
    navigator.serviceWorker.register('service-worker.js', {
        scope: './'
    }).then(function (registration) {
        var serviceWorker;
        if (registration.installing) {
            serviceWorker = registration.installing;
            document.querySelector('#kind').textContent = 'installé';
        } else if (registration.waiting) {
            serviceWorker = registration.waiting;
            document.querySelector('#kind').textContent = 'en attente';
        } else if (registration.active) {
            serviceWorker = registration.active;
            document.querySelector('#kind').textContent = 'actif';
        }
        if (serviceWorker) {
            // logState(serviceWorker.state);
            serviceWorker.addEventListener('statechange', function (e) {
                // logState(e.target.state);
            });
        }
    }).catch (function (error) {
        // L'enregistrement s'est mal déroulé. Le fichier service-worker.js
        // est peut-être indisponible ou contient une erreur.
    });
} else {
    // Le navigateur ne supporte pas les service workers.
}

Spécifications

Browser compatibility

See also

• ServiceWorker Cookbook
• Using Service Workers
• Service workers basic code example
• Is ServiceWorker ready?
• Promises
• Using web workers