FetchEvent

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Le paramètre passé au gestionnaire ServiceWorkerGlobalScope.onfetch, FetchEvent représente une action de récupération qui est délivrée sur la ServiceWorkerGlobalScope d'un ServiceWorker. Il contient des informations relatives à la requête et la réponse associée, et fourni la méthode FetchEvent.respondWith() , qui permet de renvoyer une réponse arbitraire à la page controlée.

Constructeur

FetchEvent.FetchEvent()
Crée un nouvel objet FetchEvent.

Propriétés

Hérite de son ancêtre, Event.

FetchEvent.isReload Lecture seule
Retourne un Boolean qui est à true si l'évènement a été délivré avec l'intention de recharger la page, ou false sinon. Par exemple, cliquer sur le bouton recharger du navigateur est considéré comme une intention de recharger la page, tandis que cliquer sur un lien ou sur le bouton précédent du navigateur n'est pas considéré comme tel.
FetchEvent.request Lecture seule
Retourne la Request qui a déclenché l'évènement.
FetchEvent.clientId Lecture seule
Retourne l'id du Client controlé par le service worker en cours.

Propriétés dépréciées

FetchEvent.client Lecture seule
Retourne le Client controlé par le service worker en cours.

Méthodes

Hérite de son parent, ExtendableEvent.

FetchEvent.respondWith()
Promesse qui est résolue en retournant une Response ou une erreur réseau  à Fetch.
ExtendableEvent.waitUntil()

Etend la durée de vie de l'évènement. Cette méthode est destinée à être appelée dans l'EventHandler install pour le worker installing, et dans l'EventHandler active pour le worker active.

Exemples

Ce extrait de code provient de l'exemple Service Worker Fetch (lancer l'exemple dans le navigateur). Dans une partie antérieure du code,  un InstallEvent contrôle la mise en cache de plusieurs ressources. Le gestionnaire ServiceWorkerGlobalScope.onfetch attends ensuite l'évènement fetch . Une fois déclenché, FetchEvent.respondWith() retourne une promesse à la page contrôlée. Cette promesse est résolue avec comme valeur de retour la première requête d'URL qui correspond dans l'objet Cache. Si aucune correspondance n'est trouvée (i.e. la ressource n'a pas été mise en cache pendant la phase d'installation), le code va récupérer une réponse depuis le réseau.

Le code gère aussi les exceptions émises depuis l'opération ServiceWorkerGlobalScope.fetch(). A noter que qu'une réponse d'erreur HTTP (e.g., 404) ne déclenche pas d'exception. Elle retourne un objet de réponse normal avec le code d'erreur approprié.

self.addEventListener('fetch', function(event) {
  console.log('Gestion de l\'évènement de fetch pour', event.request.url);

  event.respondWith(
    caches.match(event.request).then(function(response) {
      if (response) {
        console.log('Réponse trouvée en cache:', response);

        return response;
      }
      console.log('Pas de réponse trouvée en cache. Sur le point de la récupérer via le réseau...');

      return fetch(event.request).then(function(response) {
        console.log('La réponse du réseau est:', response);

        return response;
      }).catch(function(error) {
        console.error('Récupération échouée:', error);

        throw error;
      });
    })
  );
});

Spécifications

Spécification Statut Commentaire
Service Workers
La définition de 'FetchEvent' dans cette spécification.
Version de travail Définition initiale.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support de base 40.0 44.0 (44.0) Pas de support 24 Pas de support
Fonctionnalité Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Support de base Pas de support ? 44.0 (44.0) (Oui) Pas de support ? Pas de support 44.0

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : NuclearPony
 Dernière mise à jour par : NuclearPony,