NextRequest

NextRequest erweitert die Web Request API mit zusätzlichen Komfortmethoden.

`cookies`

Lesen oder verändern des Set-Cookie Headers der Anfrage.

`set(name, value)`

Setzt einen Cookie mit dem angegebenen Namen und Wert für die Anfrage.

// Bei einer eingehenden Anfrage an /home
// Setze einen Cookie, um das Banner auszublenden
// Die Anfrage wird einen Header `Set-Cookie:show-banner=false;path=/home` haben
request.cookies.set('show-banner', 'false')

`get(name)`

Gibt den Wert des Cookies mit dem angegebenen Namen zurück. Wird der Cookie nicht gefunden, wird undefined zurückgegeben. Bei mehreren Cookies wird der erste zurückgegeben.

// Bei einer eingehenden Anfrage an /home
// { name: 'show-banner', value: 'false', Path: '/home' }
request.cookies.get('show-banner')

`getAll()`

Gibt die Werte eines Cookies zurück. Ohne Namensangabe werden alle Cookies der Anfrage zurückgegeben.

// Bei einer eingehenden Anfrage an /home
// [
//   { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
//   { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
request.cookies.getAll('experiments')
// Alternativ können alle Cookies der Anfrage abgerufen werden
request.cookies.getAll()

`delete(name)`

Löscht den Cookie mit dem angegebenen Namen aus der Anfrage.

// Gibt true für gelöscht, false wenn nichts gelöscht wurde zurück
request.cookies.delete('experiments')

`has(name)`

Gibt true zurück, wenn der Cookie in der Anfrage existiert.

// Gibt true zurück, wenn der Cookie existiert, false wenn nicht
request.cookies.has('experiments')

`clear()`

Entfernt den Set-Cookie Header aus der Anfrage.

request.cookies.clear()

`nextUrl`

Erweitert die native URL API mit zusätzlichen Komfortmethoden, 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 die searchParams { 'name': 'lee' }
request.nextUrl.searchParams

Die folgenden Optionen sind verfügbar:

Eigenschaft	Typ	Beschreibung
`basePath`	`string`	Der Basis-Pfad der URL.
`buildId`	`string` \| `undefined`	Der Build-Identifier der Next.js-Anwendung. Kann angepasst werden.
`pathname`	`string`	Der Pfadname der URL.
`searchParams`	`Object`	Die Suchparameter der URL.

Hinweis: Die Internationalisierungseigenschaften des Pages Routers sind für den App Router nicht verfügbar. Weitere Informationen zur Internationalisierung mit dem App Router.

Versionshistorie

Version	Änderungen
`v15.0.0`	`ip` und `geo` entfernt.