Server Actionとは
CoddyのReactジャーニー「Next.js の基本」セクションの一部。レッスン 29/47。
これでサーバー上のデータを読み取れるようになりました。次はもう半分の作業、データを変更することです。
最近まで、テキストを1行保存するだけでも、驚くほど多くの手順が必要でした。エンドポイントを書きました。
// app/api/items/route.js
export async function POST(request) {
const body = await request.json();
saveItem(body.text);
return Response.json({ ok: true });
}…その後、ブラウザーから呼び出しました:
await fetch('/api/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text }),
});フォームからデータベースへ1つの文字列を移動するために、2つのファイル、URL、メソッド、ヘッダー、そして双方向のJSONを扱います。
サーバーアクションはそのすべてを削除します。1行目が'use server'であるファイルに、async関数を書きましょう。
// app/actions.js
'use server';
import { saveItem } from '../lib/db';
export async function addItem(formData) {
saveItem(formData.get('text'));
}…そして、その関数をフォームに渡します。
<form action={addItem}>
<input name="text" />
<button type="submit">Add</button>
</form>これで全体です。押さえておきたい点は3つあります。
'use server'はファイルの1行目に置く必要があります。'use client'と同じ種類のマーカーですが、向きは逆です。ここでエクスポートされるものはすべてサーバー上で実行されることを示します。- 関数本体がブラウザーに届くことはありません。データベースの認証情報は関数内で安全に保たれます。ブラウザーが受け取るのは、呼び出しに使える参照だけです。
- URLを書く必要はありません。Next.jsがエンドポイントを作成します。
action={addItem}がその接続を設定します。
Fundamentalsとの違いの一つは、これらのフォーム入力が非制御であることです。useStateもvalueもonChangeも使いません。テキストはブラウザーが保持し、送信時にアクションがテキストを見つける方法はname属性です。
自分で試してみよう
このレッスンにはコードチャレンジは含まれていません。
このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。