expiration de la zone de travail

Il est assez courant de limiter la durée de stockage des éléments dans un cache ou le nombre d'éléments qui doivent l'être dans un cache. Workbox fournit cette fonctionnalité via le plug-in workbox-expiration, qui vous permet de limiter le nombre d'entrées dans un cache et / ou de supprimer les entrées mises en cache depuis une longue période.

Limiter le nombre d'entrées de cache

Pour limiter le nombre d'entrées stockées dans un cache, vous pouvez utiliser l'option maxEntries comme suit:

import {registerRoute} from 'workbox-routing';
import {CacheFirst} from 'workbox-strategies';
import {ExpirationPlugin} from 'workbox-expiration';

registerRoute(
  ({request}) => request.destination === 'image',
  new CacheFirst({
    cacheName: 'image-cache',
    plugins: [
      new ExpirationPlugin({
        maxEntries: 20,
      }),
    ],
  })
);

Ainsi, le plug-in sera ajouté à cette route. Lorsqu'une réponse mise en cache est utilisée ou qu'une nouvelle requête est ajoutée au cache, le plug-in examine le cache configuré et s'assure que le nombre d'entrées mises en cache ne dépasse pas la limite. Si c'est le cas, les entrées les plus anciennes seront supprimées.

Limiter l'âge des entrées en cache

Pour limiter la durée de mise en cache d'une requête, vous pouvez définir un âge maximal en secondes à l'aide de l'option maxAgeSeconds, comme suit:

import {registerRoute} from 'workbox-routing';
import {CacheFirst} from 'workbox-strategies';
import {ExpirationPlugin} from 'workbox-expiration';

registerRoute(
  ({request}) => request.destination === 'image',
  new CacheFirst({
    cacheName: 'image-cache',
    plugins: [
      new ExpirationPlugin({
        maxAgeSeconds: 24 * 60 * 60,
      }),
    ],
  })
);

Le plug-in vérifie et supprime les entrées après chaque mise à jour de requête ou de cache.

Utilisation avancée

Si vous souhaitez utiliser la logique d'expiration distincte de tout autre module de boîte de travail, vous pouvez le faire avec la classe CacheExpiration.

Pour appliquer des restrictions à un cache, vous devez créer une instance de CacheExpiration pour le cache que vous souhaitez contrôler, comme suit:

import {CacheExpiration} from 'workbox-expiration';

const cacheName = 'my-cache';
const expirationManager = new CacheExpiration(cacheName, {
  maxAgeSeconds: 24 * 60 * 60,
  maxEntries: 20,
});

Chaque fois que vous mettez à jour une entrée mise en cache, vous devez appeler la méthode updateTimestamp() pour que son ancienneté soit mise à jour.

await openCache.put(request, response);

await expirationManager.updateTimestamp(request.url);

Ensuite, chaque fois que vous souhaitez faire expirer un ensemble d'entrées, vous pouvez appeler la méthode expireEntries(), qui appliquera la configuration maxAgeSeconds et maxEntries.

await expirationManager.expireEntries();