Query an Enumeration Type with GraphQL

Eve Porcello
InstructorEve Porcello
Share this video with your friends

Social Share Links

Send Tweet
Published 5 years ago
Updated 4 years ago

In the GraphQL Query Language, an enum or enumeration type is a restricted list of values for a particular field. We'll query an enum field, category, in this lesson to find out the different pet categories. This lesson also takes a look at the GraphQL schema for the API.

To follow along with these queries, go to the Pet Library GraphQL Playground.

Instructor: [00:00] We've sent the allPets query, so we have some information about the pet, their name and their weight. Now, I know that Biscuit and Jungle are cats, because I know that cats, but I might not have all of them memorized.

[00:11] We want to be able to find out what category the pet belongs to. When we're using GraphQL Playground, we can hit control-space. This will surface all of the different fields that are available on this query.

[00:23] Let's go ahead and add category to our query. When I click play, we should see category being returned. Now, categories look like strings, but they all seem pretty similar. Cat, dog, stingray, and rabbit. GraphQL is a query language for your API, but it's also a type system for your API.

[00:43] The GraphQL spec describes a schema definition language, which we'll use to define all of the different queries and all of the different types that are available on this API. If you click the schema tab, you can take a look at this schema.

[00:56] allPets returns a list of pets, and I can access all of the different fields on this pet type by scrolling down. Here, it says that category returns an option called petCategory. petCategory is an enumeration type that represents a restricted list of options for this field. Cat, dog, rabbit, and stingray.

[01:18] Here's another tip you can use when exploring APIs with GraphQL Playground. You can hover over one of these field names and press command. This will allow you to click on that field, and it'll take you directly to that field definition in the schema.

[01:31] We can do that for weight, command-click, command-click for name, but we can also do it for allPets and for totalPets.

Tech
Tech
~ 5 years ago

Is there a GitHub account tied to this?. I am interested in looking "under the hood".

Eve Porcello
Eve Porcelloinstructor
~ 5 years ago

Of course! You can find the repo here.

Tech
Tech
~ 5 years ago

Awesome. Thank you so much!

~ a month ago

the pethighway seems to be down

Markdown supported.
Become a member to join the discussionEnroll Today