GraphQL 是一种用于 API 的查询语言，让客户端可以精确地获取需要的数据，而不必请求过多或过少的数据。GraphQL 将所有数据都表示为一个或多个类型，而其中之一就是枚举类型。
枚举类型是预定义的一组可能值中的一个。与其他类型不同的是，枚举类型在 GraphQL 中是一种标量类型。它们在定义 GraphQL API 时非常有用，因为它们提供了一种规范的方式来指定有效值，并且可以使用这些值来限制某些参数和查询字段。在本篇文章中，我们将介绍 GraphQL 中的枚举类型及如何在查询语言中定义它们。
定义枚举类型
在 GraphQL 中定义枚举类型时，我们需要指定枚举名称以及可能的值。例如，我们可以定义一个名为 Status 的枚举类型：
enum Status {
ACTIVE
INACTIVE
PENDING
}在这个例子中，我们定义了一个名为 Status 的枚举类型，并列出了可能的值。这些值可以是任何有效的 GraphQL 标量类型，如字符串、数字、布尔型等。
将枚举类型用于参数
一旦定义了枚举类型，我们就可以将其用作输入参数类型。例如，假设我们有一个查询，用于从数据库中获取所有活动用户的详细信息：
query {
users(status: ACTIVE) {
id
name
email
}
}在此示例中，我们使用 status 参数来过滤用户，并将枚举值 ACTIVE 传递给该参数。GraphQL 将检查传递的参数是否为有效值，并在查询中仅返回满足条件的用户。
将枚举类型用于字段
我们还可以使用枚举类型来定义查询字段的返回值。例如，我们可以定义一个查询，用于从数据库中获取所有活动用户的 ID 数组：
query {
activeUserIds {
ids
}
}在此示例中，我们定义了一个返回具有名为 ids 的字段的对象。该字段的类型为 ID。我们可以将 ids 字段定义为返回枚举类型，然后通过该查询返回仅包含活动用户 ID 的数组：
-- -------------------- ---- ------- ---- ----- - -------------- ----- - ---- ------ - ------ -------- ------- - ---- ---- - --- --- ----- ------- ------ ------- ------- ------- - ---- ----- - ---- ----- - ------ - ------ ----- -
结论
在 GraphQL 中，枚举类型是一个非常有用的特性。它们允许我们定义一个值的受限集合，并确保传递给参数或返回的值都是有效的。在查询类型中使用枚举类型可以让我们更容易地编写可维护的 GraphQL API。希望本文可以帮助您理解 GraphQL 中的枚举类型，以及如何在查询语言中正确地定义它们。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/674818b393696b0268e3d9fb