Sử dụng nested mutations

Nested mutations cho phép thực hiện mutations trên một kiểu khác với kiểu gốc trong GraphQL.

Câu queries dưới đây thực thi một mutation tiêu chuẩn, sử dụng trường mutation updatePost từ kiểu gốc:

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

Câu queries ở trên cũng có thể được thực thi thông qua một nested mutation, trong đó đối tượng post được truy vấn trước qua trường post, sau đó trường mutation update, thuộc kiểu Post, được áp dụng lên đối tượng post:

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

Các mutations cũng có thể được lồng nhau, chỉnh sửa dữ liệu trên kết quả của một mutation khác:

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
            }
          }
        }
      }
    }
  }
}

Kiểu gốc được đơn giản hóa

Nested mutations thay đổi kiểu gốc, từ QueryRoot và MutationRoot, thành một kiểu Root duy nhất xử lý cả queries lẫn mutations:

Nested mutations trong tài liệu schema

Trực quan hóa các trường mutation

Sử dụng client Voyager để trực quan hóa các trường mutation.

Với nested mutations, mọi kiểu trong schema đều có thể chứa cả trường query lẫn trường mutation. Để phân biệt chúng, phần mô tả của trường mutation được thêm tiền tố "[Mutation] ".

Ví dụ, đây là các trường của kiểu Root:

Mô tả cho kiểu Root trong tài liệu GraphiQL