Cache.keys()
Expérimental: 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 Promesse
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) {
// fait quelque chose avec votre tableau de réponses
});
Paramètres
- request Facultatif
-
La
Requête
à 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'urlhttp://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 laRequête
(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 laRéponse
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()
.
Retour
Exemples
caches.open("v1").then(function (cache) {
cache.keys().then(function (keys) {
keys.forEach(function (request, index, array) {
cache.delete(request);
});
});
});
Spécifications
Specification |
---|
Service Workers # cache-keys |
Compatibilité des navigateurs
BCD tables only load in the browser