扩展
Deprecation
使用用户界面将 GraphQL 架构中的字段标记为已弃用,无需部署任何代码。

Click to watch tutorial video - 02:33
通过用户界面,将字段标记为已弃用并说明如何替换它们,从而演进 GraphQL 架构。
字段弃用
用于将 GraphQL 架构中的字段标记为已弃用的用户界面。

弃用通知功能
每当已弃用的字段被查询时,同一 GraphQL 响应的顶层条目 extensions 下会返回一条弃用消息。
这会提示 API 的使用者更新对架构的使用方式,即使他们并未关注 introspection query。
例如,当字段 isPublished 已被弃用时,执行以下查询:
query {
posts {
title
isPublished
}
}...将返回如下响应:
{
"extensions": {
"deprecations": [
{
"message": "Use 'isStatus(status:published)' instead of 'isPublished'",
"extensions": {
...
}
}
]
},
"data": {
"posts": [
...
]
}
}