Server Actions ovat asynkronisia funktioita, jotka suoritetaan palvelimella, mutta voidaan kutsua suoraan komponenteista (mukaan lukien lomakkeista ja event handlereista) — antaen sinulle mahdollisuuden suorittaa mutaatioita (luominen/päivittäminen/poistaminen) ilman API-endpointin manuaalista rakentamista. Merkitset ne "use server" direktiivilla.
// app/todos/actions.ts
"use server";
import { revalidatePath } from "next/cache";
export async function createTodo(formData: FormData) {
const title = formData.get("title") as string;
await db.todo.create({ data: { title } }); // runs on the server — DB access, secrets
revalidatePath("/todos"); // refresh the cached page with new data
}
// app/todos/page.tsx — wire the action straight to a form
import { createTodo } from "./actions";
export default function Page() {
return (
<form action={createTodo}> {/* no onSubmit, no fetch, no /api route */}
<input name="title" />
<button>Add</button>
</form>
);
}
Lomakkeen action osoittaa Server Actioniin. Lähetyksen yhteydessä Next.js lähettää FormData palvelimelle, suorittaa funktion siellä ja voi revalidoida vaikuttavia sivuja — kaikki ilman API-reittiä ja ilman asiakaspuolen fetch-koodia.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts handlerien ja asiakaspuolen fetch-kutsujen kirjoittamista.revalidatePath/revalidateTag päivittävät välimuistissa olevia tietoja mutaation jälkeen.⚠️ Server Actions are PUBLIC endpoints under the hood — always validate input and
check authorization inside them, exactly as you would a real API route.
Server Actions tiivistävät tavanomaisen mutaatiopinoyn (API-reitti + asiakaspuolen fetch + tilankäsittely) yhdeksi palvelinfunktioksi, jonka kutsut suoraan — App Routerin vastaus lomakkeisiin ja tietojen muutoksiin.
Ne vähentävät standardikoodia, mahdollistavat progressiivisen parantamisen ja integroituvat välimuistiin/revalidointiin, mutta (kuten mikä tahansa endpointti) vaativat validointi- ja todentamistarkistuksia niiden sisällä.