Cache.add()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since avril 2018.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
La méthode add() de l'interface Cache accepte une URL, la récupère, et ajoute l'objet réponse qui en résulte dans le cache. La méthode add() est équivalent au code suivant :
fetch(url).then(function (response) {
if (!response.ok) {
throw new TypeError("bad response status");
}
return cache.put(url, response);
});
Pour des opérations plus complexes, il faut utiliser Cache.put() directement.
Note :
add() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à la requête.
Syntaxe
cache.add(request).then(function () {
//request a été ajoutée au cache
});
Paramètres
Retour
Une Promesse qui est résolue en void.
Exceptions
| Exception | Arrive quand |
|---|---|
TypeError |
Le schéma d'URL n'est pas Le statut de la réponse n'est pas dans les 200 (i.e., une requête qui a échoué.) Cela peut arriver si la requête échoue, mais également si la requête est une cross-origin no-cors (auquel cas le statut retourné est systématiquement 0.) |
Exemples
Ce bloc de code attends le déclenchement d'un InstallEvent, puis lance waitUntil qui gère la phase d'installation de l'application. Cela consite à appeler CacheStorage.open afin de créer un nouveau cache, puis à utiliser Cache.add pour y ajouter des ressources.
this.addEventListener("install", function (event) {
event.waitUntil(
caches.open("v1").then(function (cache) {
return cache.add("/sw-test/index.html");
}),
);
});
Spécifications
| Specification |
|---|
| Service Workers # cache-add |
Compatibilité des navigateurs
Loading…