CacheStorage.keys()

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.

La méthode keys() de l'interface CacheStorage retourne une Promise qui renvoie une liste content les chaines de caractères correspondant à tous les noms des Cache suivient par l'objet CacheStorage. Utilisez cette méthode pour itérer sur une liste de tous les objets Cache.

Syntaxe

caches.keys().then(function(keyList) {
  // faire quelquechose avec votre keylist
});

Retour

une Promise qui retourne une liste de noms de Cache contenus dans un objet CacheStorage.

Paramètres

Aucun.

Exemples

Dans ce fragment de code, nous attendons un évènement, et bloquons avec un waitUntil(), qui nettoie les anciens caches, inutilisés, avant que le nouveau service worker soit activé. Nous avons ici une liste blanche contenant le nom du cache que nous voulons garder. Nous retournons les clés des caches dans l'objet CacheStorage utilisant CacheStorage.keys, pour ensuite vérifier que chaque clé est dans la liste blance. Sinon, nous la supprimons avec delete().

then.addEventListener('activate', function(event) {
  var cacheWhitelist = ['v2'];

  event.waitUntil(
    caches.keys().then(function(keyList) {
      return Promise.all(keyList.map(function(key) {
        if (cacheWhitelist.indexOf(key) === -1) {
          return caches.delete(keyList[i]);
        }
      });
    })
  );
});

Spécifications

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

Compatibilités des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base 40.0 44 (44)[1] Pas de support ? Pas de support
Fonctionnalité Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Support de base Pas de support Pas de support 44.0 (44) (Oui) (Oui) (Oui) 40.0

[1] Les services workers (et Push) on été désactivés dans la Sortie du support étendu de Firefox 45 (ESR.)

Voir aussi

Étiquettes et contributeurs liés au document

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