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 évènement 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'évènement pour le service worker (démo en direct). Le code écoute 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

Compatibilité des navigateurs

Voir aussi

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