NextRequest

NextRequest extiende la API Web Request con métodos adicionales de conveniencia.

`cookies`

Lee o modifica el encabezado Set-Cookie de la solicitud.

`set(nombre, valor)`

Dado un nombre, establece una cookie con el valor proporcionado en la solicitud.

// Dada una solicitud entrante /home
// Establece una cookie para ocultar el banner
// la solicitud tendrá un encabezado `Set-Cookie:show-banner=false;path=/home`
request.cookies.set('show-banner', 'false')

`get(nombre)`

Dado un nombre de cookie, devuelve su valor. Si no se encuentra la cookie, devuelve undefined. Si hay múltiples cookies, devuelve la primera.

// Dada una solicitud entrante /home
// { name: 'show-banner', value: 'false', Path: '/home' }
request.cookies.get('show-banner')

`getAll()`

Dado un nombre de cookie, devuelve sus valores. Si no se proporciona nombre, devuelve todas las cookies de la solicitud.

// Dada una solicitud entrante /home
// [
//   { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
//   { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
request.cookies.getAll('experiments')
// Alternativamente, obtiene todas las cookies de la solicitud
request.cookies.getAll()

`delete(nombre)`

Dado un nombre de cookie, elimina la cookie de la solicitud.

// Devuelve true si se eliminó, false si no había nada que eliminar
request.cookies.delete('experiments')

`has(nombre)`

Dado un nombre de cookie, devuelve true si existe en la solicitud.

// Devuelve true si la cookie existe, false si no
request.cookies.has('experiments')

`clear()`

Elimina el encabezado Set-Cookie de la solicitud.

request.cookies.clear()

`nextUrl`

Extiende la API nativa URL con métodos adicionales de conveniencia, incluyendo propiedades específicas de Next.js.

// Dada una solicitud a /home, pathname es /home
request.nextUrl.pathname
// Dada una solicitud a /home?name=lee, searchParams es { 'name': 'lee' }
request.nextUrl.searchParams

Las siguientes opciones están disponibles:

Propiedad	Tipo	Descripción
`basePath`	`string`	La ruta base de la URL.
`buildId`	`string` \| `undefined`	El identificador de compilación de la aplicación Next.js. Puede personalizarse.
`pathname`	`string`	El pathname de la URL.
`searchParams`	`Object`	Los parámetros de búsqueda de la URL.

Nota: Las propiedades de internacionalización del Enrutador de Páginas no están disponibles para usar en el Enrutador de Aplicaciones. Más información sobre internacionalización con el Enrutador de Aplicaciones.

Historial de versiones

Versión	Cambios
`v15.0.0`	Se eliminaron `ip` y `geo`.

On this page