コンテンツへスキップ
uencoder

GraphQL Mutation

GraphQL ミューテーション(GraphQL Mutation)は mutation { field(args) { result } } 構文で書き込み操作を実行して結果を返す、GraphQL の書き込みエントリポイントである。

目的

GraphQL でデータ変更(作成・更新・削除)を実行し、変更されたデータを返す。クエリと型システムを共有する。

メカニズム

mutation キーワードの後に操作名、変数、選択セットが続く。サーバーはミューテーションリゾルバー(副作用)を実行し、選択セットで宣言されたフィールドを返す。クエリと分離されているため、直列実行が可能である。

ユースケース

  • API のデータ書き込み
  • フォーム送信
  • ステートの変更

関連ツール

References