Server Actions yra async funkcijos, kurios bėgina serveryje, tačiau gali būti iškviečiamos tiesiogiai iš jūsų komponentų (įskaitant formas ir įvykių tvarkytuvus) – tai leidžia jums atlikti mutacijas (sukurti/atnaujinti/trinti) be reikalo rankiniu būdu kurti API galinį tašką. Juos žymite "use server" direktyva.
;
{ revalidatePath } ;
() {
title = formData.() ;
db..({ : { title } });
();
}
// 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>
);
}
Formos atributas action nurodo Server Action. Kai pateikiate, Next.js nusiunčia FormData į serverį, vykdo funkciją ten ir gali pakartotinai patikrinti paveiktus puslapius – visa tai be API maršruto ir be kliento pusės fetch kodo.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts tvarkytuvų ir kliento fetch rašymo.revalidatePath/revalidateTag atnaujina kešuotus duomenis po mutacijos.⚠️ 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 sumažina įprastą mutacijos krūvą (API maršrutą + kliento fetch + būsenos tvarkymu) į vieną serverio funkciją, kurią tiesiogiai iškviečiate – tai App Router atsakas į formas ir duomenų pokyčius.
Jie sumažina šablonų kiekį, suteikia progresyvaus patobulinimo galimybę ir integruojasi su kešavimu/revalidacija, tačiau (kaip ir bet kuris galinį tašką) reikalingos validacijos ir autentifikacijos patikros jų viduje.