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.
La méthode keys()
de l'interface Cache
retourne une Promise
qui est résolue en un tableau de clé de Cache
.
Les requêtes sont retournées dans le même ordre que l'ordre d'insertion.
Note: Les requêtes avec des URLs déjà présentes mais des headers différents peuvent être retournées si leurs réponses comportent le header VARY
.
Syntaxe
cache.keys(request,{options}).then(function(response) { //do something with your response array });
Retour
Une Promise
qui est résolue en un tableau de clé de Cache
.
Paramètres
- request Facultatif
- La
Request
à retourner, si une clé en particulier est désirée. - options Facultatif
- Un objet dont les paramètres contrôlent comment le matching est effectué lors de l'opération
keys
. Les options disponibles sont : -
ignoreSearch
: UnBoolean
qui spécifie si le matching doit ignorer ou non la query string dans l'url. Si mis àtrue
, la partie?value=bar
de l'urlhttps://foo.com/?value=bar
sera ignorée lors du matching. Est àfalse
par défaut.ignoreMethod
: UnBoolean
qui, quand mis àtrue
, empêche les opérations de matching de valider la méthodeHTTP
de laRequest
(en temps normal, seulesGET
etHEAD
sont autorisées). Est àfalse
par défaut.ignoreVary
: UnBoolean
qui, quand mis àtrue,
indique à l'opération de matching de ne pas effectuer le matchingVARY
des header. En d'autres termes, si l'URL correspond, un match sera obtenu peu importe que laResponse
ait un headerVARY
ou non. Est àfalse
par défaut.cacheName
: UneDOMString
qui représente un cache spécifique où effectuer la recherche. A noter que cette option est ignorée parCache.keys()
.
Exemples
caches.open('v1').then(function(cache) { cache.keys().then(function(response) { response.forEach(function(element, index, array) { cache.delete(element); }); }); })
Spécifications
Spécification | Statut | Commentaire |
---|---|---|
Service Workers La définition de 'Cache' dans cette spécification. |
Version de travail | Définition initiale. |
Compatibilités des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Support de base | 40.0 | 39 (39) | 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 | Pas de support | 39.0 (39) | ? | Pas de support | ? | Pas de support | 40.0 |