Menu

NextResponse

NextResponse 扩展了 Web Response API,增加了一些便捷方法。

cookies

读取或修改响应的 Set-Cookie header。

set(name, value)

给定一个名称,在响应中设置具有给定值的 cookie。

// 给定传入请求 /home
let response = NextResponse.next()
// 设置一个 cookie 来隐藏横幅
response.cookies.set('show-banner', 'false')
// 响应将包含 `Set-Cookie:show-banner=false;path=/home` header
return response

get(name)

给定一个 cookie 名称,返回该 cookie 的值。如果未找到 cookie,则返回 undefined。如果找到多个 cookie,则返回第一个。

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

getAll()

给定一个 cookie 名称,返回该 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 名称,从响应中删除该 cookie。

// 给定传入请求 /home
let response = NextResponse.next()
// 删除成功返回 true,没有删除任何内容返回 false
response.cookies.delete('experiments')

json()

生成具有给定 JSON 主体的响应。

app/api/route.ts
import { NextResponse } from 'next/server'
 
export async function GET(request: Request) {
  return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 })
}
app/api/route.js
import { NextResponse } from 'next/server'
 
export async function GET(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))

可以在使用 NextResponse.redirect() 方法之前创建和修改 URL。例如,你可以使用 request.nextUrl 属性获取当前 URL,然后修改它以重定向到不同的 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)
// 添加新的 header
newHeaders.set('x-version', '123')
// 然后生成带有新 headers 的响应
return NextResponse.next({
  request: {
    // 新的请求 headers
    headers: newHeaders,
  },
})