NextRequest
NextRequest erweitert die Web Request API um zusätzliche Hilfsmethoden.
cookies
Liest oder verändert den Set-Cookie-Header der Anfrage.
set(name, value)
Setzt ein Cookie mit dem angegebenen Namen und Wert in der Anfrage.
// Bei eingehender Anfrage /home
// Setzt ein Cookie, um das Banner auszublenden
// Die Anfrage erhält einen `Set-Cookie:show-banner=false;path=/home`-Header
request.cookies.set('show-banner', 'false')get(name)
Gibt den Wert des Cookies mit dem angegebenen Namen zurück. Wenn das Cookie nicht gefunden wird, wird undefined zurückgegeben. Bei mehreren gefundenen Cookies wird der erste zurückgegeben.
// Bei eingehender Anfrage /home
// { name: 'show-banner', value: 'false', Path: '/home' }
request.cookies.get('show-banner')getAll()
Gibt die Werte des Cookies mit dem angegebenen Namen zurück. Wenn kein Name angegeben ist, werden alle Cookies der Anfrage zurückgegeben.
// Bei eingehender Anfrage /home
// [
// { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
// { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
request.cookies.getAll('experiments')
// Alternativ alle Cookies der Anfrage abrufen
request.cookies.getAll()delete(name)
Löscht das Cookie mit dem angegebenen Namen aus der Anfrage.
// Gibt true zurück, wenn gelöscht, false wenn nichts gelöscht wurde
request.cookies.delete('experiments')has(name)
Gibt true zurück, wenn das Cookie mit dem angegebenen Namen in der Anfrage existiert.
// Gibt true zurück, wenn das Cookie existiert, sonst false
request.cookies.has('experiments')clear()
Entfernt den Set-Cookie-Header aus der Anfrage.
request.cookies.clear()nextUrl
Erweitert die native URL-API um zusätzliche Hilfsmethoden, einschließlich Next.js-spezifischer Eigenschaften.
// Bei einer Anfrage an /home ist pathname /home
request.nextUrl.pathname
// Bei einer Anfrage an /home?name=lee sind searchParams { 'name': 'lee' }
request.nextUrl.searchParamsVersionsverlauf
| Version | Änderungen |
|---|---|
v13.0.0 | useSearchParams eingeführt. |