graphql-request-helper

graphql-request-helper

Helper Class of Graphql Client

Getting Started

Installing

$ npm install graphql-request-helper

Example

import { GraphQLClient } from "graphql-request-helper";

Create Graphql Client

const graphQLClient = new GraphQLClient("http://localhost:3000/api/graphql");

Performing a Query request

const data = await graphQLClient.query({
  name: "getAnimals",
  fields: [
    "id",
    "name",
    "age",
    {
      name: "family",
      fields: ["id", "name"],
    },
  ],
  params: {
    age: 3,
  },
});

GraphQLClient receives the above fields and params and sends the following request

query{
    getAnimals(age: 3){
        id
        name
        age
        family{
            id
            name
        }
    }
}

Performing a Mutation request

const data = await graphQLClient.mutation({
  name: "addAnimal",
  fields: [
    "id",
    "name",
    "age",
    {
      name: "family",
      fields: ["id", "name"],
    },
  ],
  params: {
    name: "puppy",
    age: 1,
    isCute: true,
  },
});

GraphQLClient receives the above fields and params and sends the following request

mutation{
    addAnimal(name: "puppy", age: 1, isCute: true){
        id
        name
        age
        family{
            id
            name
        }
    }
}

Catch an Error

import { GraphQLError } from "graphql-request-helper";

try {
  const data = await graphQLClient.query({
    // ...
  });
} catch (e) {
  if (e instanceof GraphQLError) {
    console.log(e.errors);
  }
}

then e.errors will be like this

[
  {
    "message": "Schema is not configured for mutations.",
    "locations": [
      {
        "line": 1,
        "column": 1
      }
    ]
  }
]