En GraphQL, los Enums (abreviatura de "Enumerations") son un tipo especial de datos que permite definir un conjunto de valores posibles para un campo. Los Enums son útiles cuando se desea restringir un campo a un conjunto específico de valores predefinidos, lo que ayuda a evitar errores y a mejorar la claridad del esquema.

• Definición de Enums: Los Enums se definen en el esquema de GraphQL y especifican un conjunto de valores posibles.
• Uso de Enums en Tipos: Los Enums se pueden utilizar como tipos de campo en objetos, entradas y otros tipos de GraphQL.
• Validación Automática: GraphQL valida automáticamente que los valores proporcionados para los campos de tipo Enum sean uno de los valores permitidos.

A continuación, se muestra un ejemplo de cómo definir un Enum en un esquema de GraphQL:

En este ejemplo, hemos definido un Enum llamado Role con tres valores posibles: ADMIN, USER y GUEST.

Los Enums se pueden utilizar en varios lugares dentro del esquema de GraphQL. Aquí hay un ejemplo de cómo usar el Enum Role en un tipo de objeto:

En este ejemplo, el campo role del tipo User utiliza el Enum Role. Esto significa que el campo role solo puede tener uno de los valores definidos en el Enum Role.

Consulta con Enums

A continuación, se muestra un ejemplo de una consulta que devuelve usuarios y sus roles:

Mutación con Enums

A continuación, se muestra un ejemplo de una mutación que crea un nuevo usuario con un rol específico:

Ejercicio 1: Definir y Usar un Enum

1. Definir un Enum: Define un Enum llamado Status con los valores ACTIVE, INACTIVE y PENDING.
2. Usar el Enum en un Tipo: Crea un tipo Task que tenga un campo status de tipo Status.
3. Consulta y Mutación: Escribe una consulta para obtener todas las tareas y sus estados, y una mutación para crear una nueva tarea con un estado específico.

Solución

1. Definir el Enum Status:

2. Crear el Tipo Task:

3. Consulta para Obtener Tareas:

4. Mutación para Crear una Nueva Tarea:

• Valores Inválidos: Asegúrate de que los valores proporcionados para los campos de tipo Enum sean uno de los valores permitidos. GraphQL lanzará un error si se proporciona un valor no válido.
• Actualización de Enums: Si necesitas agregar o eliminar valores de un Enum, ten en cuenta que esto puede afectar a las consultas y mutaciones existentes. Planifica cuidadosamente cualquier cambio en los Enums.

Los Enums en GraphQL son una herramienta poderosa para definir conjuntos de valores predefinidos y mejorar la claridad y la validación de los esquemas. Al utilizar Enums, puedes asegurarte de que los campos solo contengan valores válidos, lo que reduce la posibilidad de errores y mejora la consistencia de los datos. En el próximo módulo, exploraremos otros tipos avanzados de GraphQL, como interfaces y uniones.