rsnext/errors/next-dynamic-api-wrong-context.mdx

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

46 lines
1.2 KiB
Text
Raw Normal View History

---
title: Dynamic API was called outside request
---
#### Why This Error Occurred
A Dynamic API was called outside a request scope. (Eg.: Global scope).
Note that Dynamic APIs could have been called deep inside other modules/functions (eg.: third-party libraries) that are not immediately visible.
#### Possible Ways to Fix It
Make sure that all Dynamic API calls happen in a request scope.
Example:
```diff
// app/page.ts
import { cookies } from 'next/headers'
- const cookieStore = cookies()
export default function Page() {
+ const cookieStore = cookies()
return ...
}
```
```diff
// app/foo/route.ts
import { headers } from 'next/headers'
- const headersList = headers()
export async function GET() {
+ const headersList = headers()
return ...
}
```
### Useful Links
- [`headers()` function](https://nextjs.org/docs/app/api-reference/functions/headers)
- [`cookies()` function](https://nextjs.org/docs/app/api-reference/functions/cookies)
- [`draftMode()` function](https://nextjs.org/docs/app/api-reference/functions/draft-mode)
- [`unstable_noStore()` function](https://nextjs.org/docs/app/api-reference/functions/unstable_noStore)
- [`unstable_cache()` function](https://nextjs.org/docs/app/api-reference/functions/unstable_cache)