ما طبقات التخزين المؤقت التي يوفرها Next.js؟

Question

Accepted Answer

يحتوي App Router على **طبقات تخزين مؤقت متعددة** تعمل معاً. فهم هذه الطبقات يوضح سبب ظهور البيانات القديمة أحياناً وكيفية التحكم في حداثة البيانات.

## الأربع طبقات تخزين

```text
1. Request Memoization — dedupes identical fetch() calls within ONE render pass
2. Data Cache          — persists fetch() results across requests & deploys (server)
3. Full Route Cache    — caches the rendered HTML/RSC of static routes (build time)
4. Router Cache        — client-side cache of visited routes (in the browser, per session)
```

## 1. Request Memoization

```tsx
// the SAME fetch in a layout AND a page → only ONE network request per render
const user = await fetch("/api/user"); // automatically deduped
```

## 2. Data Cache (الواحدة التي تضبطها أكثر)

```tsx
fetch(url, { cache: "force-cache" });       // cached (default) — like SSG
fetch(url, { cache: "no-store" });          // never cached — fresh every request
fetch(url, { next: { revalidate: 60 } });   // cached, refreshed every 60s — ISR
fetch(url, { next: { tags: ["posts"] } });  // taggable for on-demand invalidation
```

## 3 و 4. طبقات التوجيه

**Full Route Cache** يخزن المسارات المعروضة بشكل ثابت؛ **Router Cache** يحتفظ بالمسارات المزارة سابقاً في المتصفح بحيث تكون العودة/الانتقال والملاحة المتكررة فورية.

## إبطال التخزين المؤقت عند التعديل

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

revalidatePath("/blog");        // invalidate a specific route's cache
revalidateTag("posts");         // invalidate every fetch tagged "posts"
router.refresh();               // (client) clear the Router Cache for current route
```

بعد إنشاء/تحديث البيانات (غالباً في Server Action)، تستدعي `revalidatePath`/`revalidateTag` حتى تعيد الصفحات المتأثرة جلب البيانات ويرى المستخدمون التغيير.

## المشكلة الشائعة

```text
"Why is my data stale after an update?" → a cache (usually Data or Router cache)
is serving the old value. Fix: revalidateTag/revalidatePath after the mutation,
or use cache: "no-store" for always-fresh data.
```

(ملاحظة: أصول التخزين المؤقت تغيرت عبر إصدارات Next.js المختلفة — تحقق من إصدارك، حيث تقوم بعض الإصدارات الحديثة بتخزين أقل عدوانية بشكل افتراضي.)

## لماذا يهم

التخزين المؤقت متعدد الطبقات العدواني في Next.js هو ما يجعله سريعاً، لكنه أيضاً المصدر الأول لالتباس "لماذا بياناتي قديمة؟".

معرفة الطبقات الأربع، التحكم في Data Cache لكل جلب (`no-store`/`revalidate`/tags)، وإبطال البيانات باستخدام `revalidatePath`/`revalidateTag` بعد التعديلات ضروري للحصول على الأداء وحداثة البيانات الصحيحة.