弃用
弃用字段废弃

字段废弃

Included in the “Power Extensions” bundle

在升级 GraphQL 模式时,某些字段可能不再需要,可能会被该字段更优的实现所取代。在这种情况下,我们可以废弃过时的字段,并提供废弃原因,以通知并促使用户在其客户端中切换到新字段。

此扩展提供了一个用于废弃字段的用户界面。

说明

站点中新增了一个「字段废弃列表」自定义文章类型。我们可以在菜单中的「字段废弃列表」页面浏览其条目,并点击「添加新字段废弃列表」在编辑器中添加新条目。

字段废弃列表
字段废弃列表

字段废弃列表编辑器

每个字段废弃列表包含一个或多个条目,每个条目包含以下元素:

  • 要废弃的字段
  • 废弃原因(当废弃字段被查询时,将显示在 GraphQL 响应中)

字段废弃条目

创建字段废弃列表后,我们可以通过编辑对应的模式配置,并在「字段废弃列表」区块下从列表中选择该项目,使自定义端点和 Persisted Query 使用它。

在模式配置中选择字段废弃列表