Menggunakan nested mutations

Nested mutations memungkinkan untuk melakukan mutations pada tipe selain tipe root dalam GraphQL.

Query di bawah ini mengeksekusi mutation standar, menggunakan field mutation updatePost dari tipe root:

mutation {
  updatePost(input: {
    id: 5,
    title: "New title"
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      title
    }
  }
}

Query di atas juga dapat dieksekusi melalui nested mutation, di mana objek post pertama-tama di-query melalui field post, kemudian field mutation update, yang termasuk dalam tipe Post, diterapkan pada objek post tersebut:

mutation {
  post(by: {id: 5}) {
    update(input: {
      title: "New title"
    }) {
      status
      post {
        title
      }
    }
  }
}

Mutations juga dapat bersarang, memodifikasi data pada hasil dari mutation lain:

mutation {
  createPost(input: {
    title: "First title"
  }) {
    status
    postID
    post {
      update(input: {
        title: "Second title",
        contentAs: { html: "Some content" }
      }) {
        status
        post {
          title
          content
          addComment(input: {
            commentAs: { html: "My first comment" }
          }) {
            status
            commentID
            comment {
              content
              date
            }
          }
        }
      }
    }
  }
}

Tipe root yang disederhanakan

Nested mutations mengubah tipe root, dari QueryRoot dan MutationRoot, menjadi satu tipe Root tunggal yang menangani baik queries maupun mutations:

Nested mutations dalam dokumentasi skema

Memvisualisasikan field mutation

Gunakan klien Voyager untuk memvisualisasikan field-field mutation.

Dengan nested mutations, setiap tipe dalam skema dapat mengandung field query maupun mutation. Untuk membedakannya, deskripsi field mutation diawali dengan label "[Mutation] ".

Misalnya, berikut adalah field-field untuk tipe Root:

Deskripsi untuk tipe Root dalam dokumentasi GraphiQL