Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

graphql-operation-to-pojo

Package Overview
Dependencies
Maintainers
1
Versions
10
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

graphql-operation-to-pojo

Converts GraphQL operations to plain old JS objects (POJOs), ready to to be serialized to JSON

  • 1.0.10
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

graphql-operation-to-pojo

Converts GraphQL operations to plain old JS objects (POJOs), ready to to be serialized to JSON.

This can be used to parse the info argument (GraphQLResolveInfo) passed to GraphQL resolvers.

Installation

npm i -S graphql-operation-to-pojo

Or:

yarn add graphql-operation-to-pojo

Usage

myResolver(obj, args, context, info) {
    const queryPOJO = graphqlOperationToPOJO(info)
    ...
}

There is also a helper function to serialize the result to a JSON string:

const jsonString = graphqlOperationToJSON(info)

(This is equivalent to calling JSON.stringify(graphqlOperationToPOJO(info)))

Options

Options can optionally be passed as a second argument, e.g.:

graphqlOperationToPOJO(info, {
    includeFieldPath: true,
    includeReturnType: true,
})

Available options:

  • includeFieldPath: boolean (defaults to false)

    If true, a path property will be added to each field object and set to the path to the field from the root of the query, e.g. 'hero.name'

  • includeReturnTypes: boolean (defaults to false)

    If true, the return type of each field will be included in the result.

Tip: When using includeReturnTypes, you can use getNamedType() from graphql.js to strip any wrapping non-null or list types and get the underlying type. For example:

import { getNamedType } from 'graphql'
...
/*
Suppose we're running a query that returns a list of users:

  type Query {
    users: [User!]!
  }
*/
const returnType = getNamedType(queryPojo.fields[0].returnType)
console.log(returnType.toString())
// Output: 'User'

Examples

Given the query:

query {
    hero(episode: NEWHOPE) {
        name
        friends {
            name
            appearsIn
        }
    }
}

graphqlOperationToPOJO will return:

{
    "operation": "query",
    "fields": [
        {
            "name": "hero",
            "fields": [
                {
                    "name": "name"
                },
                {
                    "name": "friends",
                    "fields": [
                        {
                            "name": "name"
                        },
                        {
                            "name": "appearsIn"
                        }
                    ]
                }
            ],
            "arguments": {
                "episode": "NEWHOPE"
            }
        }
    ]
}

Aliases

If the query contains aliases, the field object will include an alias property, e.g.:

{
    hero(episode: NEWHOPE) {
        heroName: name
    }
}
{
    "operation": "query",
    "fields": [
        {
            "name": "hero",
            "fields": [
                {
                    "name": "name",
                    "alias": "heroName"
                }
            ],
            "arguments": {
                "episode": "NEWHOPE"
            }
        }
    ]
}

Fragments

Type conditions for fragments are stored in a fragmentType property, e.g.:

{
    character(id: "1000") {
        ... on Human {
            id
            name
            friends {
                id
            }
        }
        ... on Droid {
            name
            friends {
                name
            }
        }
    }
}
{
    "operation": "query",
    "fields": [
        {
            "name": "character",
            "fields": [
                {
                    "name": "id",
                    "fragmentType": "Human"
                },
                {
                    "name": "name",
                    "fragmentType": "Human"
                },
                {
                    "name": "friends",
                    "fragmentType": "Human",
                    "fields": [
                        {
                            "name": "id"
                        }
                    ]
                },
                {
                    "name": "name",
                    "fragmentType": "Droid"
                },
                {
                    "name": "friends",
                    "fragmentType": "Droid",
                    "fields": [
                        {
                            "name": "name"
                        }
                    ]
                }
            ],
            "arguments": {
                "id": "1000"
            }
        }
    ]
}

Keywords

FAQs

Package last updated on 10 Jan 2021

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc