Express integration in GraphQL - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is Express integration in the context of GraphQL?

Express integration means using the Express web server to handle GraphQL requests, allowing you to serve a GraphQL API through Express routes.

beginner

Which Express middleware is commonly used to connect GraphQL with Express?

The middleware called express-graphql is commonly used to connect GraphQL with Express, enabling a GraphQL HTTP server.

intermediate

How do you set up a basic GraphQL endpoint in Express?

You import <code>express-graphql</code>, create an Express app, then use <code>app.use('/graphql', graphqlHTTP({ schema, rootValue, graphiql: true }))</code> to set up the GraphQL endpoint.

beginner

What is the purpose of enabling graphiql: true in Express GraphQL middleware?

Setting graphiql: true enables an interactive in-browser tool to test and explore your GraphQL API easily.

intermediate

Can Express integration with GraphQL handle both queries and mutations?

Yes, Express integration with GraphQL can handle both queries (to fetch data) and mutations (to modify data) through the same endpoint.

Which package is used to integrate GraphQL with Express?

A graphql-server-express

B express-graphql

C express-graphql-server

D graphql-express

The correct package to integrate GraphQL with Express is express-graphql.

What does the graphiql option enable in Express GraphQL middleware?

A An interactive GraphQL IDE in the browser

B Automatic schema generation

C Database connection pooling

D Logging of GraphQL queries

Setting graphiql: true enables an interactive GraphQL IDE in the browser.

Which Express method is used to add the GraphQL endpoint?

A app.post()

B app.get()

C app.use()

D app.listen()

The app.use() method is used to add middleware like the GraphQL endpoint.

In Express GraphQL integration, what is the role of the schema?

A Defines the data types and operations available

B Stores user sessions

C Handles HTTP requests

D Manages database connections

The schema defines the data types and operations (queries and mutations) available in GraphQL.

Can you use Express GraphQL middleware to serve multiple GraphQL endpoints?

A No, only one endpoint is allowed

B Only with additional plugins

C Only if you use different ports

D Yes, by using <code>app.use()</code> with different paths

You can serve multiple GraphQL endpoints by using app.use() with different paths.

Explain how to set up a GraphQL API using Express from scratch.

Think about the steps from installing packages to running the server.

Describe the benefits of integrating GraphQL with Express.

Consider why Express is a good choice for serving GraphQL.

Practice

1. What is the main purpose of using express-graphql middleware in an Express app?

easy

A. To create a new database connection

B. To connect a GraphQL schema to the Express server for handling HTTP requests

C. To serve static files like images and CSS

D. To replace Express with a GraphQL server

Solution

1. Step 1: Understand the role of middleware in Express

   Middleware functions in Express handle requests and responses, adding features to the server.

2. Step 2: Identify what express-graphql does

   This middleware connects a GraphQL schema and resolvers to Express, enabling GraphQL queries over HTTP.

3. Final Answer:

   To connect a GraphQL schema to the Express server for handling HTTP requests -> Option B

4. Quick Check:

   express-graphql middleware = Connect GraphQL to Express [OK]

Hint: Middleware connects GraphQL schema to Express HTTP server [OK]

Common Mistakes:

• Thinking it creates a database connection
• Confusing it with static file serving
• Assuming it replaces Express entirely

2. Which of the following is the correct way to use express-graphql middleware in an Express app?

easy

A. app.get('/graphql', graphqlHTTP(mySchema));

B. app.use('/graphql', graphqlHTTP(schema, rootResolver));

C. app.post('/graphql', graphqlHTTP({ rootValue: rootResolver }));

D. app.use('/graphql', graphqlHTTP({ schema: mySchema, rootValue: rootResolver, graphiql: true }));

Solution

1. Step 1: Recall the correct syntax for express-graphql middleware

   The middleware is used with app.use and takes an options object with keys like schema, rootValue, and graphiql.

2. Step 2: Check each option for correct usage

   app.use('/graphql', graphqlHTTP({ schema: mySchema, rootValue: rootResolver, graphiql: true })); correctly uses app.use with an options object including schema, rootValue, and graphiql. Others either misuse method or pass wrong arguments.

3. Final Answer:

   app.use('/graphql', graphqlHTTP({ schema: mySchema, rootValue: rootResolver, graphiql: true })); -> Option D

4. Quick Check:

   express-graphql needs options object with schema and rootValue [OK]

Hint: Use app.use with options object for express-graphql [OK]

Common Mistakes:

• Using app.get or app.post instead of app.use
• Passing schema and rootValue as separate arguments
• Omitting the graphiql option during development

3. Given this Express setup with GraphQL:

const express = require('express');
const { graphqlHTTP } = require('express-graphql');
const { buildSchema } = require('graphql');

const schema = buildSchema(`
  type Query {
    hello: String
  }
`);

const root = {
  hello: () => 'Hello world!'
};

const app = express();
app.use('/graphql', graphqlHTTP({ schema: schema, rootValue: root, graphiql: false }));

app.listen(4000);

What will be the JSON response to this POST query to /graphql?

{"query": "{ hello }"}

medium

A. {"data":{"hello":"Hello world!"}}

B. {"error":"Query not found"}

C. {"data":{"hello":null}}

D. SyntaxError

Solution

1. Step 1: Understand the schema and resolver

   The schema defines a Query type with a field hello returning a String. The root resolver returns 'Hello world!' for hello.

2. Step 2: Analyze the query and response

   The query requests { hello }. The resolver returns 'Hello world!', so the response JSON includes this under data.

3. Final Answer:

   {"data":{"hello":"Hello world!"}} -> Option A

4. Quick Check:

   Query hello returns 'Hello world!' [OK]

Hint: Query matches resolver return value exactly [OK]

Common Mistakes:

• Expecting an error when schema and resolver match
• Confusing null with missing data
• Assuming graphiql affects response format

4. You wrote this Express GraphQL setup:

app.use('/graphql', graphqlHTTP({
  schema: mySchema,
  rootValue: rootResolver
}));

But when you send queries, you get an error: Cannot POST /graphql. What is the likely cause?

medium

A. You did not enable the body parser middleware for JSON

B. You did not define the schema correctly

C. You used app.get instead of app.use

D. You forgot to import express-graphql

Solution

1. Step 1: Understand the error message

   The error 'Cannot POST /graphql' means Express does not recognize POST requests to that route.

2. Step 2: Check middleware setup for POST data

   GraphQL POST requests send JSON body. Express needs body parser middleware (like express.json()) to parse JSON bodies before graphqlHTTP.

3. Final Answer:

   You did not enable the body parser middleware for JSON -> Option A

4. Quick Check:

   Missing JSON body parser causes POST errors [OK]

Hint: Always add express.json() before graphqlHTTP for POST [OK]

Common Mistakes:

• Assuming graphqlHTTP handles JSON parsing automatically
• Confusing app.use with app.get
• Blaming schema definition for routing errors

5. You want to add a new Query field user(id: ID!): User to your GraphQL schema in Express. The User type has fields id and name. Which of the following shows the correct way to extend the schema and resolver for this, assuming you have a getUserById function?

hard

A. Schema: type Query { user(id: String): User } and resolver: { user: (id) => getUserById(id) }

B. Schema: type Query { user: User } and resolver: { user: () => getUserById() }

C. Schema: type Query { user(id: ID!): User } and resolver: { user: ({id}) => getUserById(id) }

D. Schema: type Query { user(id: ID!): User } and resolver: { user: (args) => getUserById(args) }

Solution

1. Step 1: Define schema with required argument and User type

   The schema must declare user(id: ID!): User to require an ID argument and return a User object.

2. Step 2: Write resolver matching argument destructuring

   The resolver function receives an object with arguments, so destructure {id} and pass it to getUserById.

3. Final Answer:

   Schema: type Query { user(id: ID!): User } and resolver: { user: ({id}) => getUserById(id) } -> Option C

4. Quick Check:

   Schema arg ID! and resolver destructure args [OK]

Hint: Destructure args object in resolver for required ID [OK]

Common Mistakes:

• Not marking ID as non-null with !
• Passing args incorrectly in resolver
• Using wrong argument type in schema