[GraphQL] Create an Input Object Type for Complex Mutations

When we have certain mutations that require more complex input parameters, we can leverage the Input Object Type in GraphQL. In this video, we’ll learn how to create an Input Object Type and how to add it to a GraphQL Mutation Type.

const express     = require('express');
const graphqlHttp = require('express-graphql');
const {
          getVideoById, getVideos, createVideo
      }           = require('./data/index');
const server      = express();
const port        = process.env.PORT || 3000;

const {
          GraphQLSchema, GraphQLObjectType, GraphQLInputObjectType, GraphQLString, GraphQLList, GraphQLInt, GraphQLNonNull, GraphQLBoolean, GraphQLID
      } = require('graphql');

const videoType = new GraphQLObjectType({
    name        : 'video',
    description : 'A video on Egghead.io',
    fields      : {
        id       : {
            type        : GraphQLID,
            description : 'The id of the video'
        },
        title    : {
            type        : GraphQLString,
            description : 'The title of the video'
        },
        duration : {
            type        : GraphQLInt,
            description : 'The duration of the video'
        },
        watched  : {
            type        : GraphQLBoolean,
            description : 'Whether or no the viewer watched the video'
        }
    }
});

const videoInputType = new GraphQLInputObjectType({
    name   : 'videoInput',
    fields : {
        title    : {
            type        : new GraphQLNonNull(GraphQLID),
            description : 'The title of the video'
        },
        duration : {
            type        : new GraphQLNonNull(GraphQLInt),
            description : 'The duration of the video'
        },
        watched  : {
            type : new GraphQLNonNull(GraphQLBoolean)
        }
    }
});

const mutationType = new GraphQLObjectType({
    name        : 'Mutation',
    description : 'The root Mutation type',
    fields      : {
        createVideo : {
            type    : videoType,
            args    : {
                video : {
                    type : new GraphQLNonNull(videoInputType),
                },
            },
            resolve : (_, args) => {
                return createVideo(args.video)
            }
        }
    }
});

const queryType = new GraphQLObjectType({
    name        : 'QueryType',
    description : 'The root query type',
    fields      : {
        videos : {
            type    : new GraphQLList(videoType),
            resolve : getVideos
        },
        video  : {
            type    : videoType,
            args    : {
                id : {
                    type        : new GraphQLNonNull(GraphQLID),
                    description : 'The id of the video'
                }
            },
            resolve : (_, args) => getVideoById(args.id)
        }
    }
});

const schema = new GraphQLSchema({
    query    : queryType,
    mutation : mutationType
});

server.use('/graphql', graphqlHttp({
                                       schema,
                                       graphiql : true, // use graphiql interface
                                   }));

server.listen(port, () => {
    console.log(`Listening on http`)
})

In GraphiQL:

mutation video {
  createVideo(video: {
    title:"GraphQL",
    duration:100,
    watched: false
  }) {
    id,
    title
  }
}