Server Actions, sunucu üzerinde çalışan ancak bileşenlerinizden doğrudan çağrılabilen (formlar ve olay işleyicileri de dahil) eşzamansız işlevlerdir — bunlar size API endpoint'ini elle oluşturmadan mutasyonlar (oluştur/güncelle/sil) gerçekleştirmenize izin verir. Bunları "use server" yönergesi ile işaretlersiniz.
;
{ 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>
);
}
Formun action özelliği Server Action'a işaret eder. Gönderme sırasında, Next.js FormData'yı sunucuya gönderir, orada işlevi çalıştırır ve etkilenen sayfaları yeniden doğrulayabilir — tümü API rotası olmadan ve istemci tarafı fetch kodu olmadan.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts işleyicileri ve istemci fetch'leri yazmadan mutasyonlar.revalidatePath/revalidateTag mutasyon sonrası önbelleğe alınan veriyi yeniler.⚠️ 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, olağan mutasyon yığınını (API rotası + istemci fetch + durum yönetimi) doğrudan çağırdığınız tek bir sunucu işlevine daraltır — formlar ve veri değişiklikleri için App Router'ın yanıtıdır.
Şablon kodunu azaltır, kademeli geliştirmeyi etkinleştirir ve önbelleğe alma/yeniden doğrulamayla entegre olur, ancak (herhangi bir endpoint gibi) içlerinde doğrulama ve kimlik doğrulama kontrolleri gerektirir.