workbox-expiration

Dość powszechne jest wprowadzanie w pamięci podręcznej ograniczeń dotyczących czasu, przez jaki elementy mają być przechowywane w pamięci podręcznej, lub liczby elementów w pamięci podręcznej. Workbox udostępnia tę funkcję za pomocą wtyczki workbox-expiration, która pozwala ograniczyć liczbę wpisów w pamięci podręcznej lub usunąć wpisy, które były w pamięci podręcznej od dłuższego czasu.

Ogranicz liczbę wpisów w pamięci podręcznej

Aby ograniczyć liczbę wpisów przechowywanych w pamięci podręcznej, możesz użyć opcji maxEntries w ten sposób:

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

Dzięki temu wtyczka zostanie dodana do tej trasy. Po użyciu odpowiedzi z pamięci podręcznej lub dodaniu do niej nowego żądania wtyczka sprawdzi skonfigurowaną pamięć podręczną i upewni się, że liczba wpisów w pamięci podręcznej nie przekracza limitu. Jeśli tak, najstarsze wpisy zostaną usunięte.

Ogranicz wiek wpisów w pamięci podręcznej

Aby ograniczyć czas przechowywania żądania, możesz określić maksymalny wiek w sekundach za pomocą opcji maxAgeSeconds, na przykład:

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

Wtyczka sprawdza i usuwa wpisy po każdym żądaniu lub aktualizacji pamięci podręcznej.

Zaawansowane użycie

Jeśli chcesz używać logiki wygaśnięcia niezależnie od innego modułu Workbox, możesz to zrobić za pomocą klasy CacheExpiration.

Aby zastosować ograniczenia do pamięci podręcznej, utwórz wystąpienie CacheExpiration dla pamięci podręcznej, którą chcesz kontrolować, w ten sposób:

import {CacheExpiration} from 'workbox-expiration';

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

Po każdej aktualizacji wpisu w pamięci podręcznej musisz wywołać metodę updateTimestamp(), aby zaktualizować jego wiek.

await openCache.put(request, response);

await expirationManager.updateTimestamp(request.url);

Jeśli zechcesz, aby określony zbiór wpisów utracił ważność, możesz wywołać metodę expireEntries(), co spowoduje wymuszenie konfiguracji maxAgeSeconds i maxEntries.

await expirationManager.expireEntries();