44d1a1cb15
This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459
37 lines
1.4 KiB
Text
37 lines
1.4 KiB
Text
---
|
|
title: Deleting Query Parameters In Middlewares
|
|
---
|
|
|
|
## Why This Error Occurred
|
|
|
|
In previous versions of Next.js, we were merging query parameters with the incoming request for rewrites happening in middlewares, to match the behavior of static rewrites declared in the config. This forced Next.js users to use empty query parameters values to delete keys.
|
|
|
|
We are changing this behavior to allow extra flexibility and a more streamlined experience for users. So from now on, query parameters will not be merged and thus the warning.
|
|
|
|
```ts filename="middleware.ts"
|
|
import type { NextRequest } from 'next/server'
|
|
import { NextResponse } from 'next/server'
|
|
|
|
export default function middleware(request: NextRequest) {
|
|
const nextUrl = request.nextUrl
|
|
nextUrl.searchParams.delete('key') // <-- this is now possible! 🎉
|
|
return NextResponse.rewrite(nextUrl)
|
|
}
|
|
```
|
|
|
|
## Possible Ways to Fix It
|
|
|
|
If you are relying on the old behavior, please add the query parameters manually to the rewritten URL. Using `request.nextUrl` would do that automatically for you.
|
|
|
|
```ts filename="middleware.ts"
|
|
import type { NextRequest } from 'next/server'
|
|
import { NextResponse } from 'next/server'
|
|
|
|
export default function middleware(request: NextRequest) {
|
|
const nextUrl = request.nextUrl
|
|
nextUrl.pathname = '/dest'
|
|
return NextResponse.rewrite(nextUrl)
|
|
}
|
|
```
|
|
|
|
This warning will be removed in the next version of Next.js.
|