معالج التخزين المؤقت المخصص في Next.js
في Next.js، يستخدم معالج التخزين المؤقت الافتراضي لموجه الصفحات (Pages Router) وموجه التطبيق (App Router) تخزين نظام الملفات. لا يتطلب هذا أي تكوين، ولكن يمكنك تخصيص معالج التخزين المؤقت باستخدام حقل cacheHandler
في ملف next.config.js
.
module.exports = {
cacheHandler: require.resolve('./cache-handler.js'),
cacheMaxMemorySize: 0, // تعطيل التخزين المؤقت في الذاكرة الافتراضي
}
عرض مثال لـ معالج التخزين المؤقت المخصص ومعرفة المزيد حول التنفيذ.
مرجع API
يمكن لمعالج التخزين المؤقت تنفيذ الطرق التالية: get
، set
، و revalidateTag
.
get()
المعامل | النوع | الوصف |
---|---|---|
key | string | المفتاح للقيمة المخزنة مؤقتًا. |
تُرجع القيمة المخزنة مؤقتًا أو null
إذا لم يتم العثور عليها.
set()
المعامل | النوع | الوصف |
---|---|---|
key | string | المفتاح لتخزين البيانات تحته. |
data | Data أو null | البيانات المراد تخزينها مؤقتًا. |
ctx | { tags: [] } | وسوم التخزين المؤقت المقدمة. |
تُرجع Promise<void>
.
revalidateTag()
المعامل | النوع | الوصف |
---|---|---|
tag | string | وسم التخزين المؤقت لإعادة التحقق منه. |
تُرجع Promise<void>
. تعرف على المزيد حول إعادة التحقق من البيانات أو دالة revalidateTag()
.
معلومة مفيدة:
revalidatePath
هي طبقة تسهيلية فوق وسوم التخزين المؤقت. استدعاءrevalidatePath
سوف يستدعي دالةrevalidateTag
الخاصة بك، والتي يمكنك بعد ذلك اختيار ما إذا كنت تريد وضع وسوم لمفاتيح التخزين المؤقت بناءً على المسار.
سجل الإصدارات
الإصدار | التغييرات |
---|---|
v14.1.0 | أصبح cacheHandler مستقرًا. |
v13.4.0 | يدعم incrementalCacheHandlerPath (تجريبي) revalidateTag . |
v13.4.0 | يدعم incrementalCacheHandlerPath (تجريبي) الإخراج المستقل. |
v12.2.0 | تمت إضافة incrementalCacheHandlerPath (تجريبي). |