การเลิกใช้งาน
การเลิกใช้งานDeprecation Notifier

Deprecation Notifier

Included in the “Power Extensions” bundle

ส่งข้อมูลการเลิกใช้งานในการตอบสนองต่อ query (ไม่ใช่เฉพาะตอนทำ introspection เท่านั้น) ภายใต้รายการระดับบนสุด extensions

คำอธิบาย

ทุกครั้งที่มีการ query ฟิลด์ที่ถูกเลิกใช้งาน ข้อความแจ้งการเลิกใช้งานจะถูกส่งกลับในการตอบสนอง GraphQL เดียวกัน ภายใต้รายการระดับบนสุด extensions

สิ่งนี้จะแจ้งเตือนผู้ใช้ API ของเราให้อัปเกรดการใช้งาน schema แม้ในกรณีที่พวกเขาไม่ได้ให้ความสนใจกับ introspection query

ตัวอย่างเช่น การรัน query นี้ ซึ่งฟิลด์ isPublished ถูกเลิกใช้งาน:

query {
  posts {
    title
    isPublished
  }
}

...จะได้รับการตอบสนองดังนี้:

{
  "extensions": {
    "deprecations": [
      {
        "message": "Use 'isStatus(status:published)' instead of 'isPublished'",
        "extensions": {
          ...
        }
      }
    ]
  },
  "data": {
    "posts": [
      ...
    ]
  }
}