data de validade da caixa de trabalho

É bastante comum querer colocar restrições em um cache em termos de quanto tempo ele permite que itens sejam armazenados em um cache ou quantos itens precisam ser mantidos em um cache. O Workbox oferece essa funcionalidade usando o plug-in workbox-expiration, que permite limitar o número de entradas em um cache e / ou remover entradas armazenadas em cache por um longo período.

Restringir o número de entradas de cache

Para restringir o número de entradas armazenadas em um cache, use a opção maxEntries da seguinte maneira:

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,
      }),
    ],
  })
);

Com isso, o plug-in será adicionado a essa rota. Depois que uma resposta em cache é usada ou uma nova solicitação é adicionada ao cache, o plug-in verifica o cache configurado e garante que o número de entradas em cache não exceda o limite. Se for o caso, as entradas mais antigas serão removidas.

Restringir a idade das entradas em cache

Para restringir por quanto tempo uma solicitação é armazenada em cache, é possível definir uma idade máxima em segundos usando a opção maxAgeSeconds da seguinte maneira:

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,
      }),
    ],
  })
);

O plug-in verificará e removerá entradas após cada solicitação ou atualização de cache.

Uso avançado

Se você quiser usar a lógica de expiração separada de qualquer outro módulo do Workbox, faça isso com a classe CacheExpiration.

Para aplicar restrições a um cache, crie uma instância de CacheExpiration para o cache que você quer controlar, da seguinte maneira:

import {CacheExpiration} from 'workbox-expiration';

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

Sempre que você atualizar uma entrada armazenada em cache, será necessário chamar o método updateTimestamp() para que a idade dela seja atualizada.

await openCache.put(request, response);

await expirationManager.updateTimestamp(request.url);

Em seguida, sempre que você quiser expirar um conjunto de entradas, chame o método expireEntries(), que vai aplicar a configuração maxAgeSeconds e maxEntries.

await expirationManager.expireEntries();