Query Shorthand

如果文档仅包含一个操作，且该操作是一个不定义变量且没有指令的查询，则该操作可以用一种简写形式表示，该形式省略 query 关键字和操作名。

例如，下面这个未命名的查询操作使用了查询简写。

Example № 5{
  field
}

查询简写形式不允许描述（Descriptions）。

参数的顺序无关

参数可以以任意语法顺序提供，并保持相同的语义意义。

下面这两个操作在语义上是等价的：

Example № 11{
  picture(width: 200, height: 100)
}

Example № 12{
  picture(height: 100, width: 200)
}

片段内的变量使用

变量可以在片段中使用。变量在给定操作中具有全局作用域，因此在片段中使用的变量必须在任何传递性地使用该片段的顶层操作中声明。如果某个变量在片段中被引用，但该变量未被包含的操作定义，则该操作是无效的（参见 All Variable Uses Defined）。

语义

指令顺序具有重要性

指令可以以特定的语法顺序提供，该顺序可能具有语义解释。

下面这两种类型定义可能具有不同的语义含义：

Example № 33type Person
  @addExternalFields(source: "profiles")
  @excludeField(name: "photo") {
  name: String
}

Example № 34type Person
  @excludeField(name: "photo")
  @addExternalFields(source: "profiles") {
  name: String
}

解析 Schema Coordinate

一个 SchemaCoordinate 使用独立的词法记号集合，是一个自包含的文法，它并不包含在任何 Document 中。SchemaCoordinate 的源文本必须是 SourceCharacter 的序列。

与其它 GraphQL 文档不同，SchemaCoordinate 的字符序列中不得包含 Whitespace 或其它 Ignored 文法。这确保每个 schema coordinate 都有单一、不含歧义且唯一的词法形式。

解析 Schema Coordinate 的含义

要引用某个 schema element，必须在某个 GraphQL schema 的语境中解释该 schema coordinate。

如果找不到相应的 schema element，解析函数不会返回值（且不抛错）。然而，如果 schema coordinate 中的任何非叶子节点在给定 schema 中找不到，则应抛出错误。

示例

上表示例展示了基于下面模式的每种 schema element 的一个 schema coordinate 示例。

type Query {
  searchBusiness(criteria: SearchCriteria!): [Business]
}

input SearchCriteria {
  name: String
  filter: SearchFilter
}

enum SearchFilter {
  OPEN_NOW
  DELIVERS_TAKEOUT
  VEGETARIAN_MENU
}

type Business {
  id: ID
  name: String
  email: String @private(scope: "loggedIn")
}

directive @private(scope: String!) on FIELD_DEFINITION

内建标量

GraphQL 指定了一组明确定义的基本标量类型：Int、 Float、String、Boolean 和 ID。GraphQL 框架应当支持这些类型，且任何以这些名称提供类型的 GraphQL 服务必须遵循本文档中对它们的描述行为。例如，服务不得将名为 Int 的类型用来表示 64 位数字、国际化信息或其它与本文档定义不符的内容。

当从 __Schema 自省类型返回类型集合时，所有被引用的内建标量必须被包含。如果某个内建标量在模式中未被任何字段、参数或输入字段引用，则不得将其包含在内。

在使用类型系统定义语言表示 GraphQL 模式时，为简洁起见应省略所有内建标量。

自定义标量

除了内建标量外，GraphQL 服务还可以使用自定义标量类型。例如，服务可以定义一个名为 UUID 的标量，虽然它以字符串序列化，但遵循 RFC 4122。在查询类型为 UUID 的字段时，就可以依赖结果能被符合 RFC 4122 的解析器解析。另一个常见的自定义标量示例是 URL，它以字符串序列化，但服务保证其为有效的 URL。

在定义自定义标量时，GraphQL 服务应当通过 @specifiedBy 指令或自省字段 specifiedByURL 提供一个 标量规范 URL。该 URL 必须指向一个可读的人类规范，说明该标量的数据格式、序列化及强制规则。

例如，提供 UUID 标量的服务可以链接到 RFC 4122，或是定义了该 RFC 的合理子集的自定义文档。如果存在 标量规范 URL，了解该规范的系统和工具应当遵循规范中描述的规则。

Example № 43scalar UUID @specifiedBy(url: "https://tools.ietf.org/html/rfc4122")
scalar URL @specifiedBy(url: "https://tools.ietf.org/html/rfc3986")
scalar DateTime
  @specifiedBy(url: "https://scalars.graphql.org/andimarek/date-time")

自定义的 标量规范 URL 应当提供单一、稳定的格式以避免歧义。如果所链接的规范仍在变动，服务应链接到固定版本而不是可能会变化的资源。

一旦定义，自定义的 标量规范 URL 不应被更改。更改可能会破坏工具链或在所链接规范的内容中引入向后不兼容的变更。

内建标量类型不得提供 标量规范 URL，因为它们已在本文档中指定。

结果强制与序列化

GraphQL 服务在准备某个标量类型字段的返回值时，必须遵守该标量类型所描述的契约，要么对值进行强制转换，要么在无法强制转换或强制转换可能导致数据丢失时产生 执行错误。

GraphQL 服务可以决定允许将不同的内部类型在合理且不丢失信息的情况下强制为期望的返回类型。例如在将一个字段的返回类型强制为 Int 时，布尔值 true 可能产生 1，或者字符串值 "123" 可能被解析为十进制数 123。但当内部类型的强制会不可避免地丢失信息时，必须抛出 执行错误。

由于这种强制行为对于 GraphQL 服务的客户端不可观测，强制的精确规则由实现决定。唯一的要求是服务必须产出符合期望标量类型的值。

GraphQL 标量应根据所使用的序列化格式进行序列化。对每个标量类型可能存在最合适的序列化原语，服务应在适当时生成该原语。

关于在常见 JSON 和其它格式中标量的序列化的详细信息，请参阅 序列化格式 一节。

输入强制

如果 GraphQL 服务期望某标量类型作为参数的输入，则输入强制是可观察的，其规则必须被明确规定。如果输入值不符合强制规则，必须引发 请求错误（输入值在执行开始前验证）。

GraphQL 有不同的常量字面量来表示整数与浮点输入值，强制规则可能会根据遇到的输入值类型有所不同。GraphQL 可能通过变量参数化，变量值通常在通过诸如 HTTP 的传输时进行序列化。由于某些常见的序列化（例如 JSON）并不区分整数和浮点值，因此当数值具有空的分数部分（例如 1.0）时会被解释为整数输入值，否则解释为浮点输入值。

对于下文所有类型（Non-Null 除外），如果显式提供了 null，则输入强制的结果为 null。

字段顺序

查询对象时，结果映射的字段概念上按执行过程中遇到它们的顺序排序，排除那些类型不适用的片段以及通过 @skip 或 @include 指令被跳过的字段或片段。使用 CollectFields() 算法可以正确地产生此顺序。

能够表示有序映射的响应序列化格式应保持该顺序。只能表示无序映射的序列化格式（例如 JSON）应在文本上保留该顺序。也就是说，如果以 {foo, bar} 的顺序查询了两个字段，那么生成的 JSON 序列化应以相同顺序包含 {"foo": "...", "bar": "..."}。

在响应中以与请求中出现相同的顺序表示字段，有助于调试时提高可读性，并在响应属性顺序可预测时提升解析效率。

如果一个片段在其它字段之前展开，则该片段指定的字段在响应中出现在后续字段之前。

Example № 53{
  foo
  ...Frag
  qux
}

fragment Frag on Query {
  bar
  baz
}

将产生有序结果：

Example № 54{
  "foo": 1,
  "bar": 2,
  "baz": 3,
  "qux": 4
}

如果在选择中多次查询同一字段，则其顺序以首次遇到该字段的时间为准。但类型不匹配的片段不影响排序。

Example № 55{
  foo
  ...Ignored
  ...Matching
  bar
}

fragment Ignored on UnknownType {
  qux
  baz
}

fragment Matching on Query {
  bar
  qux
  foo
}

将产生有序结果：

Example № 56{
  "foo": 1,
  "bar": 2,
  "qux": 3
}

此外，如果指令导致字段被排除，则这些字段不计入字段的排序。

Example № 57{
  foo @skip(if: true)
  bar
  foo
}

将产生有序结果：

Example № 58{
  "bar": 1,
  "foo": 2
}

结果强制

确定对象强制后的结果是 GraphQL 执行器的核心，参见 值完成（Value Completion）。

输入强制

对象从不作为有效的输入。

类型验证

如果错误地定义，对象类型可能是无效的。以下规则集必须被 GraphQL 模式中的每个对象类型遵循。

1. 对象类型必须定义一个或多个字段。
2. 对于对象类型的每个字段：
   1. 该字段在该对象类型中必须具有唯一名称；不能有两个字段共享同一名称。
   2. 字段名称不得以字符 "__"（两个下划线）开头。
   3. 字段必须返回一个使 IsOutputType(fieldType) 返回 true 的类型。
   4. 对于该字段的每个参数：
      1. 参数名称不得以字符 "__"（两个下划线）开头。
      2. 参数在该字段内必须具有唯一名称；不能有两个参数共享同一名称。
      3. 参数必须接受一个使 IsInputType(argumentType) 返回 true 的类型。
      4. 如果参数类型为 Non-Null 且未定义默认值：
         1. 该参数上不得应用 @deprecated 指令。
      5. 如果参数有默认值，则该默认值必须根据该类型的强制规则与 argumentType 兼容。
3. 对象类型可以声明它实现一个或多个唯一的接口。
4. 对象类型必须是其实现的所有接口的超集：
   1. 令该对象类型为 objectType。
   2. 对于每个声明实现的接口 interfaceType，必须使 IsValidImplementation(objectType, interfaceType) 为 true。

接口实现接口

当定义一个实现另一个接口的接口时，实现接口必须定义被实现接口所指定的每个字段。例如，接口 Resource 必须定义字段 id 才能实现 Node 接口：

Example № 70interface Node {
  id: ID!
}

interface Resource implements Node {
  id: ID!
  url: String
}

传递性实现的接口（即被实现接口所实现的接口）也必须在实现的类型或接口上被定义。例如，Image 不能仅实现 Resource 而不同时实现 Node：

Example № 71interface Node {
  id: ID!
}

interface Resource implements Node {
  id: ID!
  url: String
}

interface Image implements Resource & Node {
  id: ID!
  url: String
  thumbnail: String
}

接口定义不得包含循环引用，也不得实现自身。下例是无效的，因为 Node 与 Named 相互实现或自实现：

Counter Example № 72interface Node implements Named & Node {
  id: ID!
  name: String
}

interface Named implements Node & Named {
  id: ID!
  name: String
}

结果强制

接口类型应当提供某种方式来确定给定结果对应于哪个对象。一旦确定，接口的结果强制与该对象的结果强制相同。

输入强制

接口从不作为有效的输入。

类型验证

如果定义不当，接口类型可能是无效的。

1. 接口类型必须定义一个或多个字段。
2. 对于接口类型的每个字段：
   1. 该字段在该接口类型内必须具有唯一名称；不能有两个字段共享同一名称。
   2. 该字段的名称不得以字符 "__"（两个下划线）开头。
   3. 该字段必须返回一种使 IsOutputType(fieldType) 返回 true 的类型。
   4. 对于该字段的每个参数：
      1. 参数名称不得以字符 "__"（两个下划线）开头。
      2. 参数在该字段内必须具有唯一名称；不能有两个参数共享同一名称。
      3. 参数必须接受一种使 IsInputType(argumentType) 返回 true 的类型。
3. 接口类型可以声明它实现一个或多个唯一接口，但不得实现自身。
4. 接口类型必须是其实现的所有接口的超集：
   1. 令此接口类型为 implementingType。
   2. 对于每个被声明实现的接口 implementedType，必须使 IsValidImplementation(implementingType, implementedType) 为 true。

结果强制

联合类型应当提供某种方法来确定给定结果对应于哪个对象。一旦确定，联合类型的结果强制与该对象的结果强制相同。

输入强制

联合类型从不作为有效的输入。

类型验证

如果定义不当，联合类型可能是无效的。

1. 联合类型必须包含一个或多个唯一的成员类型。
2. 联合类型的成员类型必须全部为对象基础类型；标量、接口和联合类型不得作为联合的成员类型。同样，包装类型也不得作为联合的成员类型。

结果强制

GraphQL 服务必须返回定义集合中的某一值。如果无法合理地进行强制转换，则必须抛出一个 执行错误。

输入强制

GraphQL 有用于表示枚举输入值的常量字面量。GraphQL 字符串字面量不得被接受为枚举输入，应当引发请求错误。

对于那些在变量传输序列化中对非字符串符号值有不同表示的序列化（例如 EDN），应仅允许此类值作为枚举输入值。否则，对于大多数不区分的传输序列化，字符串可以被解释为与该名称相同的枚举输入值。

类型验证

如果定义不当，枚举类型可能是无效的。

1. 枚举类型必须定义一个或多个唯一的枚举值。

循环引用

输入对象允许将其他输入对象作为字段类型引用。当一个输入对象通过直接或间接引用链引用自身时，就会发生循环引用。

通常允许循环引用，但它们不得被定义为由一连串非空且单一的字段构成。这类输入对象是无效的，因为无法为它们提供合法的值。

下面这个循环引用的输入类型示例是有效的，因为字段 self 可以被省略或其值可以为 null。

Example № 81input Example {
  self: Example
  value: String
}

下面这个示例也是有效的，因为字段 self 可以是一个空列表。

Example № 82input Example {
  self: [Example!]!
  value: String
}

下面这个循环引用输入类型示例是无效的，因为字段 self 无法被赋予一个有限的值。

Counter Example № 83input Example {
  value: String
  self: Example!
}

下面这个示例也是无效的，因为通过 First.second 与 Second.first 字段存在非空单一的循环引用链。

Counter Example № 84input First {
  second: Second!
  value: String
}

input Second {
  first: First!
  value: String
}

结果强制

输入对象永远不是有效的结果类型。Input Object 类型不能作为对象或接口字段的返回类型。

输入强制

输入对象的值应为输入对象字面量或由变量提供的无序映射，否则必须引发 request error。无论哪种情况，输入对象字面量或无序映射都不得包含该输入对象类型未定义的字段名，否则必须引发请求错误。

强制转换的结果是一个无序映射，包含每个既由输入对象类型定义且存在值的字段。生成该映射时应遵循以下规则：

• 如果未为某已定义的输入对象字段提供值且该字段定义了默认值，则应使用根据该字段类型的强制规则强制转换后的默认值。若未提供默认值且该输入对象字段的类型为非空，则应抛出错误。否则，如果该字段非必需，则不向强制后的无序映射中添加该项。
• 如果为输入对象字段提供了显式的 null 且该字段类型不是非空类型，则在强制后的无序映射中为该字段添加值 null。换言之，显式提供 null 与未提供值在语义上不同。
• 如果为输入对象字段提供了字面量值，则在强制后的无序映射中为该字段添加根据该字段类型的输入强制规则强制后的值。
• 如果为输入对象字段提供了变量，则必须使用该变量的运行时值。如果运行时值为 null 且字段类型为非空，则必须引发 execution error。如果未提供运行时值，则应使用变量定义的默认值；如果变量定义未提供默认值，则应使用输入对象字段定义的默认值。

下面是对于具有 String 字段 a 和必需的（非空） Int! 字段 b 的输入对象类型的输入强制示例：

Example № 85input ExampleInputObject {
  a: String
  b: Int!
}

类型验证

1. Input Object 类型必须定义一个或多个输入字段。
2. 对于 Input Object 类型的每个输入字段：
   1. 该输入字段在该 Input Object 类型内必须具有唯一名称；不能有两个输入字段共享同一名称。
   2. 该输入字段的名称不得以字符 "__"（两个下划线）开头。
   3. 该输入字段必须接受一种使 IsInputType(inputFieldType) 返回 true 的类型。
   4. 如果输入字段类型为 Non-Null 且未定义默认值：
      1. 该输入字段上不得应用 @deprecated 指令。
   5. 如果该 Input Object 是一个 OneOf Input Object 则：
      1. 该输入字段的类型必须是可空的。
      2. 该输入字段不得具有默认值。
3. 如果一个输入对象通过直接或间接引用自身，则在该引用链中的至少一个字段必须是可空类型或 List 类型。
4. InputObjectDefaultValueHasCycle(inputObject) 必须为 false。

结果强制

GraphQL 服务必须返回一个有序列表作为列表类型的结果。列表中的每个元素必须是对该元素类型进行结果强制后的结果。如果无法进行合理的强制，则必须抛出一个 execution error。特别地，如果返回的不是列表，则强制应失败，因为这表示类型系统与实现之间存在预期不匹配。

如果列表的元素类型是可空的，那么在准备或强制单个列表元素时发生的错误必须导致该位置的值为 null，并在响应中添加一个 execution error。如果列表的元素类型是非空的，则发生在某个元素处的执行错误必须导致整个列表的执行错误。

输入强制

当作为输入期望时，仅在列表中每个元素都能被该列表的元素类型接受时，列表值才被接受。

如果传入列表类型的输入值 不是 列表且不是 null，则输入强制的结果为一个大小为一的列表，该单个元素值为对提供值按列表元素类型执行输入强制后的结果（注意这对于嵌套列表可递归适用）。

这允许接受一个或多个参数的输入（有时称为“var args”）将其输入类型声明为列表，而在常见的单一值情况下，客户端可以直接传递该值，而无需构造列表。

下列为不同列表类型与值的输入强制示例：

可空与可选

在 selection set 的上下文中字段始终是 可选的，字段可以被省略且选择集仍然有效（只要选择集不变为空）。然而返回 Non-Null 类型的字段在被查询时将永远不会返回 null。

输入（例如字段参数）默认也是可选的。但非空输入类型是必需的。除了不接受 null 外，它还不接受省略。为简单起见，可空类型总是可选的，非空类型总是必需的。

结果强制

在上述所有结果强制中，null 被视为有效值。要强制 Non-Null 类型的结果，应先对被包装的类型执行强制。如果该结果不是 null，则强制 Non-Null 类型的结果即为该结果。如果该结果是 null，则必须抛出一个 execution error。

输入强制

如果某个参数或输入对象字段的类型为 Non-Null，且未提供该值、被提供为字面量 null，或被提供为在运行时未提供值的变量，或该变量在运行时被赋值为 null，则必须引发一个 request error。

如果提供给 Non-Null 类型的值是一个非 null 的字面量，或是一个非空变量值，则应使用被包装类型的输入强制来进行强制。

非空参数不能被省略：

Counter Example № 87{
  fieldWithNonNullArg
}

不能向非空参数提供 null：

Counter Example № 88{
  fieldWithNonNullArg(nonNullArg: null)
}

可空类型的变量不能提供给非空参数：

Example № 89query withNullableVariable($var: String) {
  fieldWithNonNullArg(nonNullArg: $var)
}

类型验证

1. Non-Null 类型不得包装另一个 Non-Null 类型。

内建指令

内建指令 是本文规范中定义的任何指令。

GraphQL 实现应提供 @skip 和 @include 指令。

支持类型系统定义语言的 GraphQL 实现若要表示已弃用的模式部分，必须提供 @deprecated 指令。

支持类型系统定义语言的 GraphQL 实现在表示自定义标量定义时，应提供 @specifiedBy 指令。

支持类型系统定义语言的 GraphQL 实现在表示 OneOf 输入对象时，应提供 @oneOf 指令。

在使用类型系统定义语言表示 GraphQL 模式时，任何 内建指令 可为简洁起见省略。

在自省 GraphQL 服务时，所有提供的指令（包括任何 内建指令）必须包含在返回的指令集合中。

自定义指令

GraphQL 服务与客户端工具可以提供本文件中定义之外的任何附加 自定义指令。指令是用来自定义或试验性行为扩展 GraphQL 的首选方式。

指令必须仅在其声明所属的位置使用。下例定义了一个可用于注释字段的指令：

Example № 90directive @example on FIELD

fragment SomeFragment on SomeType {
  field @example
}

指令位置可以用可选的前导 | 字符来定义，以便在表示较长的位置列表时便于格式化：

Example № 91directive @example on
  | FIELD
  | FRAGMENT_SPREAD
  | INLINE_FRAGMENT

指令也可以用于注释类型系统定义语言，这对于在生成 GraphQL 执行服务、生成客户端运行时代码或其他许多扩展 GraphQL 语义的用途时提供额外元数据非常有用。

下例中，指令 @example 注释了字段与参数定义：

Example № 92directive @example on FIELD_DEFINITION | ARGUMENT_DEFINITION

type SomeType {
  field(arg: Int @example): String @example
}

可以通过包含关键字 “repeatable” 将指令定义为可重复。可重复指令在同一位置需要使用不同参数多次时非常有用，尤其是在需要通过指令向类型或模式扩展提供附加信息的场景中：

Example № 93directive @delegateField(name: String!) repeatable on OBJECT | INTERFACE

type Book @delegateField(name: "pageCount") @delegateField(name: "author") {
  id: ID!
}

extend type Book @delegateField(name: "index")

在定义指令时，该指令不得直接或间接引用自身：

Counter Example № 94directive @invalidExample(arg: String @invalidExample) on ARGUMENT_DEFINITION

类型验证

1. 指令定义必须至少包含一个 DirectiveLocation。
2. 指令定义不得包含直接引用自身的指令用法。
3. 指令定义不得包含间接引用自身的指令用法（通过引用某个类型或指令而传递性地包含对此指令的引用）。
4. 指令名称不得以字符 "__"（两个下划线）开头。
5. 对于指令的每个参数：
   1. 参数名称不得以字符 "__"（两个下划线）开头。
   2. 参数在该指令内必须具有唯一名称；不得有两个参数共享名称。
   3. 参数必须接受一种使 IsInputType(argumentType) 返回 true 的类型。

一等文档

自省系统中的所有类型都提供一个类型为 String 的 description 字段，以允许类型设计者发布除能力说明之外的文档。GraphQL 服务可以返回采用 Markdown 语法（按 CommonMark 规范）格式的 description 字段。因此，建议显示 description 的任何工具使用兼容 CommonMark 的 Markdown 渲染器。

弃用

为支持向后兼容管理，GraphQL 的字段、参数、输入字段和枚举值可以指示它们是否已弃用（isDeprecated: Boolean!），以及为何弃用的描述（deprecationReason: String）。

使用 GraphQL 自省构建的工具应尊重弃用，通过信息隐藏或面向开发者的警告来劝阻对已弃用项的使用。

稳定排序

为提高模式可读性和稳定性，应保留所有数据集合的可观察顺序。当模式由 TypeSystemDocument 生成时，自省应对每个元素列表（对象字段、输入对象字段、参数、枚举值、指令、联合成员类型以及实现的接口）按源中的相同顺序返回条目。

模式自省模式

模式自省系统本身也表示为一个 GraphQL 模式。下面是提供模式自省的完整类型系统定义集，这些在下文各节中有完整定义。

type __Schema {
  description: String
  types: [__Type!]!
  queryType: __Type!
  mutationType: __Type
  subscriptionType: __Type
  directives: [__Directive!]!
}

type __Type {
  kind: __TypeKind!
  name: String
  description: String
  # may be non-null for custom SCALAR, otherwise null.
  specifiedByURL: String
  # must be non-null for OBJECT and INTERFACE, otherwise null.
  fields(includeDeprecated: Boolean! = false): [__Field!]
  # must be non-null for OBJECT and INTERFACE, otherwise null.
  interfaces: [__Type!]
  # must be non-null for INTERFACE and UNION, otherwise null.
  possibleTypes: [__Type!]
  # must be non-null for ENUM, otherwise null.
  enumValues(includeDeprecated: Boolean! = false): [__EnumValue!]
  # must be non-null for INPUT_OBJECT, otherwise null.
  inputFields(includeDeprecated: Boolean! = false): [__InputValue!]
  # must be non-null for NON_NULL and LIST, otherwise null.
  ofType: __Type
  # must be non-null for INPUT_OBJECT, otherwise null.
  isOneOf: Boolean
}

enum __TypeKind {
  SCALAR
  OBJECT
  INTERFACE
  UNION
  ENUM
  INPUT_OBJECT
  LIST
  NON_NULL
}

type __Field {
  name: String!
  description: String
  args(includeDeprecated: Boolean! = false): [__InputValue!]!
  type: __Type!
  isDeprecated: Boolean!
  deprecationReason: String
}

type __InputValue {
  name: String!
  description: String
  type: __Type!
  defaultValue: String
  isDeprecated: Boolean!
  deprecationReason: String
}

type __EnumValue {
  name: String!
  description: String
  isDeprecated: Boolean!
  deprecationReason: String
}

type __Directive {
  name: String!
  description: String
  isRepeatable: Boolean!
  locations: [__DirectiveLocation!]!
  args(includeDeprecated: Boolean! = false): [__InputValue!]!
}

enum __DirectiveLocation {
  QUERY
  MUTATION
  SUBSCRIPTION
  FIELD
  FRAGMENT_DEFINITION
  FRAGMENT_SPREAD
  INLINE_FRAGMENT
  VARIABLE_DEFINITION
  SCHEMA
  SCALAR
  OBJECT
  FIELD_DEFINITION
  ARGUMENT_DEFINITION
  INTERFACE
  UNION
  ENUM
  ENUM_VALUE
  INPUT_OBJECT
  INPUT_FIELD_DEFINITION
}