Bird
Raised Fist0
NextJSframework~8 mins

Redirect and rewrite in middleware in NextJS - Performance & Optimization

Choose your learning style10 modes available

Start learning this pattern below

Jump into concepts and practice - no test required

or
Recommended
Test this pattern10 questions across easy, medium, and hard to know if this pattern is strong
Performance: Redirect and rewrite in middleware
MEDIUM IMPACT
This concept affects page load speed by controlling navigation early in the request lifecycle, impacting how fast users see the correct content.
Handling URL changes to redirect or rewrite paths before rendering
NextJS
import { NextResponse } from 'next/server';
export function middleware(request) {
  if (request.nextUrl.pathname === '/old-path') {
    return NextResponse.rewrite(new URL('/new-path', request.url));
  }
  return NextResponse.next();
}
Rewriting the URL in middleware avoids a client redirect and serves the new content immediately, reducing load time.
📈 Performance GainSaves one network round trip, improving LCP by 100-200ms
Handling URL changes to redirect or rewrite paths before rendering
NextJS
import { NextResponse } from 'next/server';
export function middleware(request) {
  if (request.nextUrl.pathname === '/old-path') {
    return NextResponse.redirect(new URL('/new-path', request.url));
  }
  return NextResponse.next();
}
Using Response.redirect triggers a full client-side redirect causing an extra round trip and delays page load.
📉 Performance CostBlocks rendering for 100-200ms due to extra network request
Performance Comparison
PatternDOM OperationsReflowsPaint CostVerdict
Middleware RedirectMinimal0Extra delay due to new request[!] OK
Middleware RewriteMinimal0No extra delay, direct content serving[OK] Good
Rendering Pipeline
Middleware runs before the rendering pipeline starts, intercepting requests to redirect or rewrite URLs. Redirects cause a new request cycle, while rewrites serve content directly without extra navigation.
Request Handling
Network
Rendering
⚠️ BottleneckRedirects cause additional network requests delaying the Rendering stage
Core Web Vital Affected
LCP
This concept affects page load speed by controlling navigation early in the request lifecycle, impacting how fast users see the correct content.
Optimization Tips
1Avoid redirects in middleware to prevent extra network requests.
2Use rewrites in middleware to serve content immediately and improve LCP.
3Check Network panel for redirects to identify performance bottlenecks.
Performance Quiz - 3 Questions
Test your performance knowledge
What is the main performance drawback of using a redirect in Next.js middleware?
AIt blocks JavaScript execution on the client
BIt causes an extra network request delaying page load
CIt increases DOM nodes causing reflows
DIt increases CSS selector complexity
DevTools: Network
How to check: Open DevTools, go to Network tab, reload page and watch for 3xx redirect status codes and extra requests
What to look for: Presence of redirect requests indicates slower load; absence means rewrites are used improving performance

Practice

(1/5)
1. What is the main difference between a redirect and a rewrite in Next.js middleware?
easy
A. Rewrite changes the URL in the browser, redirect does not.
B. Redirect changes the URL in the browser, rewrite does not.
C. Redirect and rewrite both change the URL in the browser.
D. Neither redirect nor rewrite affect the URL in the browser.

Solution

  1. Step 1: Understand redirect behavior

    A redirect sends the user to a new URL and updates the browser's address bar to that URL.
  2. Step 2: Understand rewrite behavior

    A rewrite changes the content served without changing the URL shown in the browser.
  3. Final Answer:

    Redirect changes the URL in the browser, rewrite does not. -> Option B
  4. Quick Check:

    Redirect updates URL, rewrite keeps URL same [OK]
Hint: Redirect changes URL; rewrite keeps URL same [OK]
Common Mistakes:
  • Thinking rewrite changes browser URL
  • Confusing redirect with rewrite
  • Assuming both always change URL
2. Which of the following is the correct way to perform a redirect in Next.js middleware?
easy
A. return NextResponse.redirect('/home');
B. return NextResponse.rewrite(new URL('/home', request.url));
C. return NextResponse.next('/home');
D. return NextResponse.redirect(new URL('/home', request.url));

Solution

  1. Step 1: Check NextResponse.redirect syntax

    The redirect method requires a full URL object, created with new URL(path, base).
  2. Step 2: Validate options

    return NextResponse.redirect(new URL('/home', request.url)); correctly uses new URL with request.url as base. return NextResponse.redirect('/home'); incorrectly passes a string instead of URL object.
  3. Final Answer:

    return NextResponse.redirect(new URL('/home', request.url)); -> Option D
  4. Quick Check:

    Redirect needs URL object [OK]
Hint: Use new URL(path, request.url) for redirects [OK]
Common Mistakes:
  • Passing string directly to redirect
  • Using rewrite instead of redirect
  • Missing base URL in new URL()
3. Given this middleware code snippet, what will happen when a user visits '/dashboard'?
import { NextResponse } from 'next/server';
export function middleware(request) {
  if (request.nextUrl.pathname === '/dashboard') {
    return NextResponse.rewrite(new URL('/profile', request.url));
  }
  return NextResponse.next();
}
medium
A. User sees content from '/profile' but URL stays '/dashboard'.
B. User is redirected to '/profile' and URL changes.
C. User stays on '/dashboard' with original content.
D. Middleware throws an error due to incorrect syntax.

Solution

  1. Step 1: Analyze rewrite usage

    The code uses NextResponse.rewrite to serve '/profile' content when URL is '/dashboard'.
  2. Step 2: Understand rewrite effect on URL

    Rewrite changes content served but keeps the browser URL unchanged as '/dashboard'.
  3. Final Answer:

    User sees content from '/profile' but URL stays '/dashboard'. -> Option A
  4. Quick Check:

    Rewrite changes content, not URL [OK]
Hint: Rewrite serves new content but keeps URL same [OK]
Common Mistakes:
  • Confusing rewrite with redirect
  • Expecting URL to change on rewrite
  • Assuming middleware throws error here
4. Identify the error in this middleware code that tries to redirect users from '/old' to '/new':
import { NextResponse } from 'next/server';
export function middleware(request) {
  if (request.nextUrl.pathname === '/old') {
    return NextResponse.redirect('/new');
  }
  return NextResponse.next();
}
medium
A. The condition should check request.url, not request.nextUrl.pathname.
B. Middleware must be async to use redirect.
C. Redirect requires a full URL object, not a string.
D. NextResponse.next() cannot be returned in middleware.

Solution

  1. Step 1: Check redirect argument type

    NextResponse.redirect expects a URL object, not a string path.
  2. Step 2: Validate other parts

    Condition and NextResponse.next() usage are correct; async not required here.
  3. Final Answer:

    Redirect requires a full URL object, not a string. -> Option C
  4. Quick Check:

    Redirect needs URL object, not string [OK]
Hint: Redirect needs new URL(path, request.url) [OK]
Common Mistakes:
  • Passing string directly to redirect
  • Making middleware async unnecessarily
  • Checking wrong request property
5. You want to redirect users to '/login' if they visit any page except '/public' or '/login'. Which middleware code correctly implements this logic?
hard
A. if (!['/public', '/login'].includes(request.nextUrl.pathname)) { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next();
B. if (['/public', '/login'].includes(request.nextUrl.pathname)) { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next();
C. if (request.nextUrl.pathname !== '/public' || request.nextUrl.pathname !== '/login') { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next();
D. if (request.nextUrl.pathname === '/public' && request.nextUrl.pathname === '/login') { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next();

Solution

  1. Step 1: Understand condition logic

    We want to redirect if the path is NOT '/public' or '/login'. Using !includes checks this correctly.
  2. Step 2: Check each option's condition

    if (!['/public', '/login'].includes(request.nextUrl.pathname)) { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next(); correctly uses negation with includes. if (['/public', '/login'].includes(request.nextUrl.pathname)) { return NextResponse.redirect(new URL('/login', request.url)); } return NextResponse.next(); redirects only on '/public' or '/login' which is wrong. Options C and D have logical errors in conditions.
  3. Final Answer:

    Option A code correctly redirects except for '/public' and '/login'. -> Option A
  4. Quick Check:

    Use !includes for exclusion check [OK]
Hint: Use !includes to exclude paths for redirect [OK]
Common Mistakes:
  • Using OR instead of AND in conditions
  • Redirecting on allowed paths
  • Incorrect logical negation