mirror of
https://github.com/hanzoai/next.js.git
synced 2026-09-24 17:00:51 +00:00
JosephandGitHub
acd7610f24
Before this guide existed, often we linked, incorrectly, to mutating-data. Also adding more related links pointing to this guide.
73 lines
1.4 KiB
Plaintext
73 lines
1.4 KiB
Plaintext
---
|
|
title: refresh
|
|
description: API Reference for the refresh function.
|
|
related:
|
|
links:
|
|
- app/guides/server-actions
|
|
---
|
|
|
|
`refresh` allows you to refresh the client router from within a [Server Action](/docs/app/guides/server-actions).
|
|
|
|
## Usage
|
|
|
|
`refresh` can **only** be called from within Server Actions. It cannot be used in Route Handlers, Client Components, or any other context.
|
|
|
|
## Parameters
|
|
|
|
```tsx
|
|
refresh(): void;
|
|
```
|
|
|
|
## Returns
|
|
|
|
`refresh` does not return a value.
|
|
|
|
## Examples
|
|
|
|
```ts filename="app/actions.ts" switcher
|
|
'use server'
|
|
|
|
import { refresh } from 'next/cache'
|
|
|
|
export async function createPost(formData: FormData) {
|
|
const title = formData.get('title')
|
|
const content = formData.get('content')
|
|
|
|
// Create the post in your database
|
|
const post = await db.post.create({
|
|
data: { title, content },
|
|
})
|
|
|
|
refresh()
|
|
}
|
|
```
|
|
|
|
```js filename="app/actions.js" switcher
|
|
'use server'
|
|
|
|
import { refresh } from 'next/cache'
|
|
|
|
export async function createPost(formData) {
|
|
const title = formData.get('title')
|
|
const content = formData.get('content')
|
|
|
|
// Create the post in your database
|
|
const post = await db.post.create({
|
|
data: { title, content },
|
|
})
|
|
|
|
refresh()
|
|
}
|
|
```
|
|
|
|
### Error when used outside Server Actions
|
|
|
|
```ts filename="app/api/posts/route.ts" switcher
|
|
import { refresh } from 'next/cache'
|
|
|
|
export async function POST() {
|
|
// This will throw an error
|
|
refresh()
|
|
}
|
|
```
|