graphql-fields

What is graphql-fields?

The graphql-fields npm package is a utility for extracting the fields requested in a GraphQL query. It helps in resolving only the necessary fields, optimizing the performance of your GraphQL server by avoiding over-fetching data.

What are graphql-fields's main functionalities?

Extracting Fields from a GraphQL Query

This feature allows you to extract the fields requested in a GraphQL query. By using the `graphqlFields` function and passing the `info` object from the resolver, you can get an object representing the fields requested. This can be used to optimize data fetching by only querying the necessary fields from your data source.

const graphqlFields = require('graphql-fields');

const resolvers = {
  Query: {
    user: (parent, args, context, info) => {
      const fields = graphqlFields(info);
      console.log(fields); // Logs the fields requested in the query
      // Fetch and return the user data based on the requested fields
    }
  }
};

Handling Nested Fields

This feature allows you to handle nested fields in a GraphQL query. The `graphqlFields` function will return an object that includes nested fields, enabling you to understand the full structure of the query and fetch data accordingly.

const graphqlFields = require('graphql-fields');

const resolvers = {
  Query: {
    user: (parent, args, context, info) => {
      const fields = graphqlFields(info);
      console.log(fields); // Logs nested fields as well
      // Fetch and return the user data based on the requested fields
    }
  }
};

Other packages similar to graphql-fields

graphql-parse-resolve-info

The graphql-parse-resolve-info package provides similar functionality by parsing the resolve info to extract the fields requested in a GraphQL query. It offers more detailed information about the query, including arguments and fragments, making it a more comprehensive solution compared to graphql-fields.

README

graphql-fields

Turns GraphQLResolveInfo into a map of the requested fields. Flattens all fragments and duplicated fields into a neat object to easily see which fields were requested at any level.

Usage

Schema Type definition

const graphqlFields = require('graphql-fields');
const graphql = require('graphql')

module.exports = new graphql.GraphQLObjectType({
    name: 'User',
    fields: {
        profile: {type: new graphql.GraphQLObjectType({
          name: 'Profile',
          fields: {
            firstName: {type: graphql.GraphQLString},
            lastName: {type: graphql.GraphQLString},
            middleName: {type: graphql.GraphQLString}
          }
        }),
        email: {type: graphql.GraphQLString},
        id: {type: graphql.GraphQLID}
    },
    resolve(root, args, info) {
      console.log(
        JSON.stringify(graphqlFields(info), null, 2);
      );
      ...
    }
});

Query

{
  user {
    ...A
    profile {
      ...B
      firstName
    }
  }
}

fragment A on User {
  ...C
  id,
  profile {
    lastName
  }
}

Fragment B on Profile {
  firstName
}

Fragment C on User {
  email,
  profile {
    middleName
  }
}

will log

{
  "profile": {
    "firstName": {},
    "lastName": {},
    "middleName": {}
  },
  "email": {},
  "id": {}
}

Why

An underlying REST api may only return fields based on query params.

{
  user {
    profile {
      firstName
    },
    id
  }
}

should request /api/user?fields=profile,id

while

{
  user {
    email
  }
}

should request /api/user?fields=email

Implement your resolve method like so:

resolve(root, args, info) {
    const topLevelFields = Object.keys(graphqlFields(info})
    return fetch(`/api/user?fields=${topLevelFields.join(',}`);
}

Tests

npm test