拡張機能
Deprecation
ユーザーインターフェースを使用して、コードをデプロイすることなくGraphQLスキーマのフィールドを非推奨にします。
Click to watch tutorial video - 02:33
ユーザーインターフェースを通じて、フィールドを非推奨にし、その置き換え方法を説明することで、GraphQLスキーマを進化させます。
フィールドの非推奨化
GraphQLスキーマのフィールドを非推奨にするためのユーザーインターフェースです。
非推奨通知機能
非推奨フィールドがクエリされるたびに、同じGraphQLレスポンスのトップレベルエントリ extensions の下に非推奨メッセージが返されます。
これにより、APIのユーザーは、イントロスペクションクエリに注意を払っていない場合でも、スキーマの使用を更新するよう促されます。
たとえば、フィールド isPublished が非推奨になっている場合、次のクエリを実行すると：
query {
posts {
title
isPublished
}
}...次のレスポンスが返されます：
{
"extensions": {
"deprecations": [
{
"message": "Use 'isStatus(status:published)' instead of 'isPublished'",
"extensions": {
...
}
}
]
},
"data": {
"posts": [
...
]
}
}
