NextResponse

NextResponse 扩展了 Web Response API，提供了更多便捷方法。

`cookies`

读取或修改响应中的 Set-Cookie 标头。

`set(name, value)`

根据给定的名称，在响应中设置具有对应值的 cookie。

// 假设传入请求为 /home
let response = NextResponse.next()
// 设置一个用于隐藏横幅的 cookie
response.cookies.set('show-banner', 'false')
// 响应将包含 `Set-Cookie:show-banner=false;path=/home` 标头
return response

`get(name)`

根据 cookie 名称返回其值。若未找到对应 cookie 则返回 undefined。若存在多个同名 cookie，则返回第一个。

// 假设传入请求为 /home
let response = NextResponse.next()
// 返回 { name: 'show-banner', value: 'false', Path: '/home' }
response.cookies.get('show-banner')

`getAll()`

根据 cookie 名称返回所有匹配值。若未指定名称，则返回响应中的所有 cookie。

// 假设传入请求为 /home
let response = NextResponse.next()
// 返回 [
//   { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
//   { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
response.cookies.getAll('experiments')
// 或者获取响应中的所有 cookie
response.cookies.getAll()

`delete(name)`

根据 cookie 名称从响应中删除对应项。

// 假设传入请求为 /home
let response = NextResponse.next()
// 返回 true 表示已删除，false 表示无操作
response.cookies.delete('experiments')

`json()`

生成包含给定 JSON 主体的响应。

import { NextResponse } from 'next/server'

export async function GET(request: Request) {
  return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 })
}

`redirect()`

生成重定向至指定 URL 的响应。

import { NextResponse } from 'next/server'

return NextResponse.redirect(new URL('/new', request.url))

URL 可在 NextResponse.redirect() 方法调用前被创建或修改。例如，可通过 request.nextUrl 属性获取当前 URL 并修改其重定向目标。

import { NextResponse } from 'next/server'

// 处理传入请求...
const loginUrl = new URL('/login', request.url)
// 向 /login URL 添加 ?from=/incoming-url 参数
loginUrl.searchParams.set('from', request.nextUrl.pathname)
// 重定向至新 URL
return NextResponse.redirect(loginUrl)

`rewrite()`

生成重写（代理）至指定 URL 的响应，同时保留原始 URL。

import { NextResponse } from 'next/server'

// 传入请求: /about，浏览器显示 /about
// 重写请求: /proxy，浏览器仍显示 /about
return NextResponse.rewrite(new URL('/proxy', request.url))

`next()`

next() 方法在中间件中特别有用，它允许提前返回并继续路由流程。

import { NextResponse } from 'next/server'

return NextResponse.next()

生成响应时还可转发 headers：

import { NextResponse } from 'next/server'

// 处理传入请求...
const newHeaders = new Headers(request.headers)
// 添加新标头
newHeaders.set('x-version', '123')
// 生成包含新标头的响应
return NextResponse.next({
  request: {
    // 新请求标头
    headers: newHeaders,
  },
})

On this page