useSSRContext() الوصول إلى سياق SSR
آخر تحديث: 2026-10-22
useSSRContext() الوصول إلى سياق SSR
تحصل useSSRContext() على كائن السياق أثناء التصيير في الخادم: استخدمها لتعليق البيانات التي يلزم إعادة استخدامها عند ترطيب العميل.
| المجموعة | دوال العرض و SSR |
|---|---|
| النوع | API |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
import { useSSRContext } from "vue"
const ctx = useSSRContext()
ctx.state = { user: "Ana" }القيمة المُرجعة：كائن سياق SSR (له قيمة في الخادم فقط)
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Shows the SSR notice.💡 نقاط مهمة
ℹ️ ملاحظة لا قيمة له إلا في مسار التصيير على الخادم؛ وعلى العميل افحص القيمة الفارغة دائماً.
💡 نصيحة الاستخدام النموذجي: تعليق البيانات المجلوبة مسبقاً على ctx لإخراجها مضمّنة في القالب، فيقرؤها العميل ثم يرطب.
⚠️ تحذير لا تصل إليها تزامنياً في مستوى أعلى المكوّن (قد تكون undefined)؛ افحصها عند الحاجة.
🏷️ دوال العرض و SSR ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س هل تُحدث خطأ على العميل؟
ج لا، تُعيد undefined، ويقع عليك فحص القيمة الفارغة.
س ما علاقتها بحالة Pinia؟
ج أثناء SSR تُعلَّق لقطة الـ store على ctx، ويقرؤها العميل عند التهيئة.
س هل يمكن تخزين دوال؟
ج يُنصح بتخزين بيانات قابلة للتسلسل فقط (صديقة لـ JSON).
