Workspace-expiration-expiration (انتهاء صلاحية صندوق العمل)

من الشائع جدًا أن تريد وضع قيود على ذاكرة التخزين المؤقت من حيث المدة التي يجب خلالها السماح بتخزين العناصر في ذاكرة التخزين المؤقت أو عدد العناصر التي يجب الاحتفاظ بها في ذاكرة التخزين المؤقت. يوفّر Workbox هذه الوظيفة من خلال المكوّن الإضافي workbox-expiration الذي يتيح لك الحدّ من عدد الإدخالات في ذاكرة التخزين المؤقت و / أو إزالة الإدخالات التي تم تخزينها مؤقتًا لفترة زمنية طويلة.

تقييد عدد إدخالات ذاكرة التخزين المؤقت

لفرض قيود على عدد الإدخالات المخزّنة في ذاكرة التخزين المؤقت، يمكنك استخدام الخيار maxEntries على النحو التالي:

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

من خلال ذلك، ستتم إضافة المكوّن الإضافي إلى هذا المسار. بعد استخدام استجابة مخزّنة مؤقتًا أو إضافة طلب جديد إلى ذاكرة التخزين المؤقت، سيفحص المكوّن الإضافي ذاكرة التخزين المؤقت التي تم إعدادها ويضمن أن عدد الإدخالات المخزنة مؤقتًا لا يتجاوز الحد الأقصى. وإذا حدث ذلك، ستتم إزالة الإدخالات الأقدم.

تقييد عمر الإدخالات المخزّنة مؤقتًا

لفرض قيود على مدة التخزين المؤقت للطلب، يمكنك تحديد الحدّ الأقصى للعمر بالثواني باستخدام خيار maxAgeSeconds على النحو التالي:

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

سيتحقق المكون الإضافي من الإدخالات ويزيلها بعد كل طلب أو تحديث لذاكرة التخزين المؤقت.

الاستخدام المتقدّم

إذا كنت تريد استخدام منطق انتهاء الصلاحية بشكل منفصل عن أي وحدة Workbox أخرى، يمكنك إجراء ذلك باستخدام الفئة CacheExpiration.

لتطبيق قيود على ذاكرة تخزين مؤقت، يمكنك إنشاء مثيل لـ CacheExpiration لذاكرة التخزين المؤقت التي تريد التحكم فيها على النحو التالي:

import {CacheExpiration} from 'workbox-expiration';

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

كلما عدَّلت إدخالاً مخزَّنًا مؤقتًا، عليك استدعاء الطريقة updateTimestamp() حتى يتم تعديل عمره.

await openCache.put(request, response);

await expirationManager.updateTimestamp(request.url);

وبعد ذلك، عندما تريد انتهاء صلاحية مجموعة من الإدخالات، يمكنك استدعاء طريقة expireEntries() التي ستفرض إعدادات maxAgeSeconds وmaxEntries.

await expirationManager.expireEntries();