简介
GraphQL 是一种用于 API 的查询语言。它提供了一种更高效、更强大、更灵活的方式来获取和修改数据。GraphQL 通过定义类型来描述数据模型，其中包括 Scalar 类型（例如字符串、整数和布尔值）和 Object 类型（例如用户、文章和评论）。除此之外，GraphQL 还提供了 Union 类型，用于将多个类型组合成一个类型。
Union 类型是什么？
Union 类型允许我们将多个类型组合成一个类型，这些类型可以是 Scalar 类型或 Object 类型。Union 类型通常用于表示某个字段的可能返回值的不同类型。例如，对于一个查询字段，可能返回一个用户或一个文章，我们可以使用 Union 类型将这两种类型组合成一个类型。
Union 类型的定义
在 GraphQL 中，我们可以使用以下语法定义 Union 类型：
union MyUnionType = Type1 | Type2 | ... | TypeN
其中，MyUnionType 是 Union 类型的名称，Type1 到 TypeN 是组成 Union 类型的类型。
Union 类型的使用
在 GraphQL 中，我们可以使用 Union 类型作为返回类型或变量类型。例如，我们可以定义一个查询字段，它可能返回一个用户或一个文章：
-- -------------------- ---- ------- ---- ----- - --------------- --------- ---------------- - ----- ------------ - ---- - ------- ---- ---- - --- --- ----- ------- - ---- ------- - --- --- ------ ------- -------- ------- -
在上面的例子中，我们定义了一个 SearchResult Union 类型，它由 User 和 Article 类型组成。我们还定义了一个查询字段 search，它接收一个关键字参数，并返回一个 SearchResult 类型的列表。当我们查询 search 字段时，它可能返回一个 User 类型的对象或一个 Article 类型的对象。
Union 类型的查询
在查询 Union 类型时，我们需要使用 inline fragments 来指定我们要查询的类型。例如，我们可以查询 search 字段并指定我们要查询的类型为 User：
query {
search(keyword: "John") {
... on User {
id
name
}
}
}在上面的查询中，我们使用了 inline fragments 来指定我们要查询的类型为 User。如果 search 字段返回的是一个 User 对象，我们就可以查询该对象的 id 和 name 字段。
Union 类型的指令
在 Union 类型中，我们可以为每个类型指定不同的指令。例如，我们可以为 User 类型指定 @deprecated 指令，表示该类型已经过时：
union SearchResult = User @deprecated(reason: "Use Person instead") | Article
在上面的例子中，我们为 User 类型指定了 @deprecated 指令，并提供了一个 reason 参数。
Union 类型的限制
在 GraphQL 中，Union 类型有一些限制。首先，Union 类型的组成类型必须是 Object 类型，不能是 Scalar 类型。其次，Union 类型中的每个类型必须是唯一的，不能重复。如果重复了，则会出现编译错误。
结论
GraphQL 中的 Union 类型提供了一种将多个类型组合成一个类型的方式，它通常用于表示某个字段的可能返回值的不同类型。在使用 Union 类型时，我们需要注意一些限制，并使用 inline fragments 来指定我们要查询的类型。同时，我们还可以为每个类型指定不同的指令，以便更好地描述我们的数据模型。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/675bf181a4d13391d8fc2fb4