NextRequest
تمتد NextRequest واجهة برمجة تطبيقات الطلب على الويب (Web Request API) مع إضافة طرق إضافية لتسهيل الاستخدام.
cookies
قراءة أو تعديل رأس Set-Cookie للطلب.
set(name, value)
بالنظر إلى اسم، يتم تعيين ملف تعريف الارتباط (cookie) بالقيمة المحددة على الطلب.
// بالنظر إلى الطلب الوارد /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الخيارات التالية متاحة:
| الخاصية | النوع | الوصف |
|---|---|---|
basePath | string | المسار الأساسي لـ URL. |
buildId | string | undefined | معرّف بناء تطبيق Next.js. يمكن تخصيصه. |
pathname | string | مسار URL. |
searchParams | Object | معلمات البحث لـ URL. |
ملاحظة: خصائص التدويل من موجه الصفحات غير متاحة للاستخدام في موجه التطبيق. تعلم المزيد عن التدويل مع موجه التطبيق.
سجل الإصدارات
| الإصدار | التغييرات |
|---|---|
v15.0.0 | تم إزالة ip و geo. |