NextRequest

NextRequest erweitert die Web Request API um zusätzliche praktische Methoden.

`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 der Cookie nicht gefunden wird, wird undefined zurückgegeben. Wenn mehrere Cookies gefunden werden, 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 wird, 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 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 zurück, wenn gelöscht, false, wenn nichts gelöscht wurde
request.cookies.delete('experiments')

`has(name)`

Gibt true zurück, wenn der Cookie mit dem angegebenen Namen 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 um zusätzliche praktische Methoden, 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.searchParams

Die folgenden Optionen sind verfügbar:

Eigenschaft	Typ	Beschreibung
`basePath`	`string`	Der Basis-Pfad der URL.
`buildId`	`string` \| `undefined`	Die Build-Kennung der Next.js-Anwendung. Kann angepasst werden.
`defaultLocale`	`string` \| `undefined`	Die Standard-Sprache für Internationalisierung.
`domainLocale`
- `defaultLocale`	`string`	Die Standard-Sprache innerhalb einer Domain.
- `domain`	`string`	Die Domain, die mit einer bestimmten Sprache verknüpft ist.
- `http`	`boolean` \| `undefined`	Gibt an, ob die Domain HTTP verwendet.
`locales`	`string[]` \| `undefined`	Ein Array verfügbarer Sprachen.
`locale`	`string` \| `undefined`	Die aktuell aktive Sprache.
`url`	`URL`	Das URL-Objekt.

Versionsverlauf

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

On this page