NextResponse
NextResponseは、追加の便利なメソッドを備えたWeb Response APIを拡張しています。
cookies
レスポンスのSet-Cookie
ヘッダーを読み取ったり、変更したりします。
set(name, value)
指定した名前で、レスポンスにクッキーを設定します。
// 受信リクエスト /home
let response = NextResponse.next()
// バナーを非表示にするクッキーを設定
response.cookies.set('show-banner', 'false')
// レスポンスには`Set-Cookie:show-banner=false;path=/home`ヘッダーが含まれます
return response
get(name)
クッキー名を指定し、そのクッキーの値を返します。クッキーが見つからない場合は、undefined
が返されます。複数のクッキーが見つかった場合は、最初のものが返されます。
// 受信リクエスト /home
let response = NextResponse.next()
// { name: 'show-banner', value: 'false', Path: '/home' }
response.cookies.get('show-banner')
getAll()
クッキー名を指定し、そのクッキーの値を返します。名前が指定されていない場合、レスポンスのすべてのクッキーを返します。
// 受信リクエスト /home
let response = NextResponse.next()
// [
// { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
// { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
response.cookies.getAll('experiments')
// あるいは、レスポンスのすべてのクッキーを取得します
response.cookies.getAll()
delete(name)
クッキー名を指定し、レスポンスからそのクッキーを削除します。
// 受信リクエスト /home
let response = NextResponse.next()
// 削除された場合はtrue、何も削除されない場合はfalseを返します
response.cookies.delete('experiments')
json()
指定されたJSONボディを持つレスポンスを生成します。
- TypeScript
- JavaScript
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))
URLは、NextResponse.redirect()
メソッドで使用される前に作成および変更することができます。たとえば、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()
メソッドは、早期に終了し、ルーティングを続けるためにMiddlewareで便利です。
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,
},
})