การใช้ Nested Mutations

Nested mutations ช่วยให้สามารถดำเนินการ mutation บน type อื่นที่ไม่ใช่ root type ใน GraphQL ได้

Query ด้านล่างนี้ดำเนินการ mutation แบบมาตรฐาน โดยใช้ mutation field updatePost จาก root type:

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

Query ข้างต้นสามารถดำเนินการผ่าน nested mutation ได้เช่นกัน โดย query post object ผ่าน field post ก่อน จากนั้นจึงนำ mutation field update ซึ่งเป็นของ type Post มาใช้กับ post object นั้น:

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

Mutations ยังสามารถซ้อนกันได้ โดยแก้ไขข้อมูลบนผลลัพธ์จาก mutation อื่น:

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

Root type แบบย่อ

Nested mutations เปลี่ยน root type จาก QueryRoot และ MutationRoot ให้เป็น type Root เดียวที่จัดการทั้ง queries และ mutations:

Nested mutations ในเอกสาร schema

การแสดงผล mutation fields

ใช้ Voyager client เพื่อแสดงผลว่า field ใดบ้างที่เป็น mutation fields

เมื่อใช้ nested mutations ทุก type ใน schema สามารถมีทั้ง query fields และ mutation fields ได้ เพื่อแยกความแตกต่าง คำอธิบายของ mutation field จะมีป้ายกำกับ "[Mutation] " นำหน้า

ตัวอย่างเช่น นี่คือ fields สำหรับ type Root:

คำอธิบาย type Root ในเอกสาร GraphiQL