GraphQL 是一种由 Facebook 开发的数据查询和操作语言，它可以用于前端和后端通信。GraphQL 具有强大的类型系统和可扩展性，可以与各种数据存储和 API 集成。除了基本的查询和变异之外，GraphQL 还提供了一些预定义指令，这些指令可以用于在运行时处理 GraphQL 查询。
指令
GraphQL 中的指令是用于修改查询结果的特殊语法构造。指令始终以 @ 开头，并且可以应用在查询、变异和字段上。下面是一些常用的指令：
@include(if: Boolean): 当 if 参数为 true 时，包括该字段。否则，该字段将被省略。@skip(if: Boolean): 当 if 参数为 true 时，省略该字段。否则，包括该字段。@deprecated(reason: String): 废弃该字段，给出原因。@key(fields: String): 用于定义唯一标识符的字段列表。@client: 用于声明该字段是客户端定义的。
@include 和 @skip
假设我们有一个查询，想要根据用户是否有一个 premium 订阅来返回不同的数据。可以通过 @include 和 @skip 指令实现：
-- -------------------- ---- -------
----- -------------------------- --------- -
---- -
--
----
-----
------ -
---
-
------------ ------------ ---------------- -
----
--------------
-
-
-指令 @include(if: $includePremium) 将决定是否包括 subscription 字段。$includePremium 是查询变量，可以动态地控制查询结果。
@deprecated
使用 @deprecated 指令可以通知客户端，某个字段被废弃了，并提供可选的原因。例如：
type User {
id: ID!
firstName: String!
lastName: String! @deprecated(reason: "Use `name` field instead.")
name: String!
}当客户端查询 firstName 时，编辑器将提示第二个字段已废弃，推荐使用 name 字段。
@key
对于具有唯一标识符的实体类型，可以使用 @key 指令来标识该类型中的字段，这样可以更轻松地在客户端缓存这些数据。例如：
type User @key(fields: "id") {
id: ID!
name: String!
email: String!
...
}使用 @key(fields: "id") 后，GraphQL 将使用 id 字段来唯一标识 User 类型。如果查询中有引用 User 类型的其他字段 (例如 Order 类型中的 customer 字段)，GraphQL 将通过 User 类型的 id 来链接这些字段。
@client
使用 @client 指令可以在客户端上定义和处理字段。例如：
-- -------------------- ---- ------- ---- ----- - -------- ----- ---- ------- - ---- ---- - --- --- ------- ----- ------- ------- ------ ------- ------- -
使用 @client 将查询从后端转移到前端，使客户端能够定义和处理查询。在上面的例子中，客户端自己负责查询用户，并将 id、name 和 email 作为查询结果返回。
结论
在 GraphQL 中，指令是实现高级查询和操作的关键元素。本文介绍了几个常见的指令，包括 @include、@skip、@deprecated、@key 和 @client。了解这些指令可以帮助开发人员更快速、更方便地处理数据查询和操作。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66f113ec6fbf960197368015