NextRequest
يمتد NextRequest من واجهة طلب الويب (Web Request API) مع إضافة طرق إضافية لتسهيل الاستخدام.
cookies
قراءة أو تعديل رأس Set-Cookie للطلب.
set(name, value)
بالنظر إلى اسم، يقوم بتعيين كوكي بقيمة معينة في الطلب.
// عند استلام طلب لـ /home
// تعيين كوكي لإخفاء اللافتة
// سيكون للطلب رأس `Set-Cookie:show-banner=false;path=/home`
request.cookies.set('show-banner', 'false')get(name)
بالنظر إلى اسم الكوكي، يقوم بإرجاع قيمة الكوكي. إذا لم يتم العثور على الكوكي، يتم إرجاع undefined. إذا تم العثور على أكثر من كوكي، يتم إرجاع الأول.
// عند استلام طلب لـ /home
// { name: 'show-banner', value: 'false', Path: '/home' }
request.cookies.get('show-banner')getAll()
بالنظر إلى اسم الكوكي، يقوم بإرجاع قيم الكوكي. إذا لم يتم تحديد اسم، يتم إرجاع جميع الكوكيز في الطلب.
// عند استلام طلب لـ /home
// [
// { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
// { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
request.cookies.getAll('experiments')
// بدلاً من ذلك، الحصول على جميع الكوكيز للطلب
request.cookies.getAll()delete(name)
بالنظر إلى اسم الكوكي، يقوم بحذف الكوكي من الطلب.
// إرجاع true إذا تم الحذف، false إذا لم يتم حذف شيء
request.cookies.delete('experiments')has(name)
بالنظر إلى اسم الكوكي، يقوم بإرجاع true إذا كان الكوكي موجودًا في الطلب.
// إرجاع true إذا كان الكوكي موجودًا، false إذا لم يكن موجودًا
request.cookies.has('experiments')clear()
إزالة رأس Set-Cookie من الطلب.
request.cookies.clear()nextUrl
يمتد من واجهة URL الأصلية مع إضافة طرق إضافية لتسهيل الاستخدام، بما في ذلك خصائص خاصة بـ Next.js.
// عند استلام طلب لـ /home، يكون pathname هو /home
request.nextUrl.pathname
// عند استلام طلب لـ /home?name=lee، يكون searchParams هو { 'name': 'lee' }
request.nextUrl.searchParamsسجل الإصدارات
| الإصدار | التغييرات |
|---|---|
v13.0.0 | تم تقديم useSearchParams. |