Menu
CoddyTech

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属性です。

自分で試してみよう

このレッスンにはコードチャレンジは含まれていません。

quiz icon腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

Next.js の基本のすべてのレッスン