أوقات التقادم (تجريبي)

تحذير: تكوين staleTimes هو ميزة تجريبية. من المحتمل أن تتغير استراتيجية التكوين هذه في المستقبل.

staleTimes هي ميزة تجريبية تتيح تكوين فترة الإبطال لذاكرة التخزين المؤقت لموجه العميل.

هذا الخيار متاح بدءًا من الإصدار v14.2.0-canary.53.

يمكنك تمكين هذه الميزة التجريبية وتوفير أوقات إعادة تحقق مخصصة عن طريق تعيين علامة staleTimes التجريبية:

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}

module.exports = nextConfig

تتوافق خصائص static و dynamic مع الفترة الزمنية (بالثواني) بناءً على أنواع مختلفة من الجلب المسبق للروابط.

  • تُستخدم الخاصية dynamic عندما لا تكون الصفحة مُولدة بشكل ثابت أو غير مسبوقة الجلب بالكامل (أي مع prefetch=).
    • الافتراضي: 0 ثانية (غير مخزنة مؤقتًا)
  • تُستخدم الخاصية static للصفحات المُولدة بشكل ثابت، أو عندما تكون خاصية prefetch في مكون Link مضبوطة على true، أو عند استدعاء router.prefetch.
    • الافتراضي: 5 دقائق

معلومة مفيدة:

  • تعتبر حدود التحميل قابلة لإعادة الاستخدام لفترة static المحددة في هذا التكوين.
  • لا يؤثر هذا على التصيير الجزئي، بمعنى أن التخطيطات المشتركة لن يتم إعادة جلبها تلقائيًا في كل تنقل، فقط جزء الصفحة الذي يتغير.
  • لا يغير هذا سلوك التخزين المؤقت للخلف/الأمام [/docs/app/building-your-application/caching#client-side-router-cache) لمنع تغيير التخطيط وفقدان موضع التمرير في المتصفح.

يمكنك معرفة المزيد عن ذاكرة التخزين المؤقت لموجه العميل هنا.

سجل الإصدارات

الإصدارالتغييرات
v14.2.0إدخال staleTimes التجريبي