Skip to main content

graphql

GraphQL.js provides a reference implementation for the GraphQL specification but is also a useful utility for operating on GraphQL files and building sophisticated tools.

This primary module exports a general purpose function for fulfilling all steps of the GraphQL specification in a single operation, but also includes utilities for every part of the GraphQL specification:

  • Parsing the GraphQL language.
  • Building a GraphQL type schema.
  • Validating a GraphQL request against a type schema.
  • Executing a GraphQL request against a type schema.

This also includes utility functions for operating on GraphQL types and GraphQL documents to facilitate building tools.

You may also import from each sub-directory directly. For example, the following two import statements are equivalent:

import { parse } from 'graphql';
import { parse } from 'graphql/language';

Index

Classes

Enumerations

Functions

Interfaces

Type aliases

Variables

Type aliases

ASTKindToNode

ASTKindToNode: { [ NodeT in ASTNode as NodeT[kind] ]: NodeT }

Utility type listing all nodes indexed by their kind.

ASTNode

ASTNode: NameNode | DocumentNode | OperationDefinitionNode | VariableDefinitionNode | VariableNode | SelectionSetNode | FieldNode | ArgumentNode | FragmentSpreadNode | InlineFragmentNode | FragmentDefinitionNode | IntValueNode | FloatValueNode | StringValueNode | BooleanValueNode | NullValueNode | EnumValueNode | ListValueNode | ObjectValueNode | ObjectFieldNode | DirectiveNode | NamedTypeNode | ListTypeNode | NonNullTypeNode | SchemaDefinitionNode | OperationTypeDefinitionNode | ScalarTypeDefinitionNode | ObjectTypeDefinitionNode | FieldDefinitionNode | InputValueDefinitionNode | InterfaceTypeDefinitionNode | UnionTypeDefinitionNode | EnumTypeDefinitionNode | EnumValueDefinitionNode | InputObjectTypeDefinitionNode | DirectiveDefinitionNode | SchemaExtensionNode | ScalarTypeExtensionNode | ObjectTypeExtensionNode | InterfaceTypeExtensionNode | UnionTypeExtensionNode | EnumTypeExtensionNode | InputObjectTypeExtensionNode

The list of all possible AST node types.

ASTVisitFn

ASTVisitFn<TVisitedNode>: (node: TVisitedNode, key: string | number | undefined, parent: ASTNode | ReadonlyArray<ASTNode> | undefined, path: ReadonlyArray<string | number>, ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>, BREAK: unknown) => any

Type parameters

Type declaration

    • (node: TVisitedNode, key: string | number | undefined, parent: ASTNode | ReadonlyArray<ASTNode> | undefined, path: ReadonlyArray<string | number>, ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>, BREAK: unknown): any

    • A visitor is comprised of visit functions, which are called on each node during the visitor’s traversal.

      Parameters

      • node: TVisitedNode
      • key: string | number | undefined
      • parent: ASTNode | ReadonlyArray<ASTNode> | undefined
      • path: ReadonlyArray<string | number>
      • ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>
      • BREAK: unknown

      Returns any

ASTVisitor

ASTVisitor: EnterLeaveVisitor<ASTNode> | KindVisitor

A visitor is provided to visit, it contains the collection of relevant functions to be called during the visitor’s traversal.

ASTVisitorKeyMap

ASTVisitorKeyMap: { [ NodeT in ASTNode as NodeT[kind] ]?: ReadonlyArray<keyof NodeT> }

A KeyMap describes each the traversable properties of each kind of node.

ConstValueNode

ConstValueNode: IntValueNode | FloatValueNode | StringValueNode | BooleanValueNode | NullValueNode | EnumValueNode | ConstListValueNode | ConstObjectValueNode

DefinitionNode

DefinitionNode: ExecutableDefinitionNode | TypeSystemDefinitionNode | TypeSystemExtensionNode

ExecutableDefinitionNode

ExecutableDefinitionNode: OperationDefinitionNode | FragmentDefinitionNode

GraphQLAbstractType

GraphQLAbstractType: GraphQLInterfaceType | GraphQLUnionType

These types may describe the parent context of a selection set.

GraphQLCompositeType

GraphQLCompositeType: GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType

These types may describe the parent context of a selection set.

GraphQLEnumValueConfigMap

GraphQLEnumValueConfigMap: ObjMap<GraphQLEnumValueConfig>

GraphQLFieldConfigArgumentMap

GraphQLFieldConfigArgumentMap: ObjMap<GraphQLArgumentConfig>

GraphQLFieldConfigMap

GraphQLFieldConfigMap<TSource, TContext>: ObjMap<GraphQLFieldConfig<TSource, TContext>>

Type parameters

  • TSource
  • TContext

GraphQLFieldMap

GraphQLFieldMap<TSource, TContext>: ObjMap<GraphQLField<TSource, TContext>>

Type parameters

  • TSource
  • TContext

GraphQLFieldResolver

GraphQLFieldResolver<TSource, TContext, TArgs, TResult>: (source: TSource, args: TArgs, context: TContext, info: GraphQLResolveInfo) => TResult

Type parameters

  • TSource
  • TContext
  • TArgs = any
  • TResult = unknown

Type declaration

GraphQLInputFieldConfigMap

GraphQLInputFieldConfigMap: ObjMap<GraphQLInputFieldConfig>

GraphQLInputFieldMap

GraphQLInputFieldMap: ObjMap<GraphQLInputField>

GraphQLInputType

GraphQLInputType: GraphQLNullableInputType | GraphQLNonNull<GraphQLNullableInputType>

GraphQLIsTypeOfFn

GraphQLIsTypeOfFn<TSource, TContext>: (source: TSource, context: TContext, info: GraphQLResolveInfo) => PromiseOrValue<boolean>

Type parameters

  • TSource
  • TContext

Type declaration

    • Parameters

      Returns PromiseOrValue<boolean>

GraphQLLeafType

GraphQLLeafType: GraphQLScalarType | GraphQLEnumType

These types may describe types which may be leaf values.

GraphQLNamedInputType

GraphQLNamedInputType: GraphQLScalarType | GraphQLEnumType | GraphQLInputObjectType

GraphQLNamedOutputType

GraphQLNamedOutputType: GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType

GraphQLNamedType

GraphQLNamedType: GraphQLNamedInputType | GraphQLNamedOutputType

These named types do not include modifiers like List or NonNull.

GraphQLNullableInputType

GraphQLNullableInputType: GraphQLNamedInputType | GraphQLList<GraphQLInputType>

These types may be used as input types for arguments and directives.

GraphQLNullableOutputType

GraphQLNullableOutputType: GraphQLNamedOutputType | GraphQLList<GraphQLOutputType>

These types may be used as output types as the result of fields.

GraphQLNullableType

GraphQLNullableType: GraphQLNamedType | GraphQLList<GraphQLType>

These types can all accept null as a value.

GraphQLOutputType

GraphQLOutputType: GraphQLNullableOutputType | GraphQLNonNull<GraphQLNullableOutputType>

GraphQLScalarLiteralParser

GraphQLScalarLiteralParser<TInternal>: (valueNode: ValueNode, variables?: Maybe<ObjMap<unknown>>) => TInternal

Type parameters

  • TInternal

Type declaration

    • (valueNode: ValueNode, variables?: Maybe<ObjMap<unknown>>): TInternal

    • Parameters

      • valueNode: ValueNode
      • optionalvariables: Maybe<ObjMap<unknown>>

      Returns TInternal

GraphQLScalarSerializer

GraphQLScalarSerializer<TExternal>: (outputValue: unknown) => TExternal

Type parameters

  • TExternal

Type declaration

    • (outputValue: unknown): TExternal

    • Parameters

      • outputValue: unknown

      Returns TExternal

GraphQLScalarValueParser

GraphQLScalarValueParser<TInternal>: (inputValue: unknown) => TInternal

Type parameters

  • TInternal

Type declaration

    • (inputValue: unknown): TInternal

    • Parameters

      • inputValue: unknown

      Returns TInternal

GraphQLType

GraphQLType: GraphQLNamedType | GraphQLList<GraphQLType> | GraphQLNonNull<GraphQLNullableType>

These are all of the possible kinds of types.

GraphQLTypeResolver

GraphQLTypeResolver<TSource, TContext>: (value: TSource, context: TContext, info: GraphQLResolveInfo, abstractType: GraphQLAbstractType) => PromiseOrValue<string | undefined>

Type parameters

  • TSource
  • TContext

Type declaration

GraphQLWrappingType

GraphQLWrappingType: GraphQLList<GraphQLType> | GraphQLNonNull<GraphQLNullableType>

These types wrap and modify other types

IntrospectionInputType

IntrospectionInputType: IntrospectionScalarType | IntrospectionEnumType | IntrospectionInputObjectType

IntrospectionInputTypeRef

IntrospectionInputTypeRef: IntrospectionNamedTypeRef<IntrospectionInputType> | IntrospectionListTypeRef<IntrospectionInputTypeRef> | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef<IntrospectionInputType> | IntrospectionListTypeRef<IntrospectionInputTypeRef>>

IntrospectionOutputType

IntrospectionOutputType: IntrospectionScalarType | IntrospectionObjectType | IntrospectionInterfaceType | IntrospectionUnionType | IntrospectionEnumType

IntrospectionOutputTypeRef

IntrospectionOutputTypeRef: IntrospectionNamedTypeRef<IntrospectionOutputType> | IntrospectionListTypeRef<IntrospectionOutputTypeRef> | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef<IntrospectionOutputType> | IntrospectionListTypeRef<IntrospectionOutputTypeRef>>

IntrospectionType

IntrospectionType: IntrospectionScalarType | IntrospectionObjectType | IntrospectionInterfaceType | IntrospectionUnionType | IntrospectionEnumType | IntrospectionInputObjectType

IntrospectionTypeRef

IntrospectionTypeRef: IntrospectionNamedTypeRef | IntrospectionListTypeRef | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef | IntrospectionListTypeRef>

SelectionNode

SelectionNode: FieldNode | FragmentSpreadNode | InlineFragmentNode

ThunkObjMap

ThunkObjMap<T>: () => ObjMap<T> | ObjMap<T>

Type parameters

  • T

ThunkReadonlyArray

ThunkReadonlyArray<T>: () => ReadonlyArray<T> | ReadonlyArray<T>

Used while defining GraphQL types to allow for circular references in otherwise immutable type definitions.

Type parameters

  • T

TypeDefinitionNode

TypeDefinitionNode: ScalarTypeDefinitionNode | ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode | UnionTypeDefinitionNode | EnumTypeDefinitionNode | InputObjectTypeDefinitionNode

Type Definition

TypeExtensionNode

TypeExtensionNode: ScalarTypeExtensionNode | ObjectTypeExtensionNode | InterfaceTypeExtensionNode | UnionTypeExtensionNode | EnumTypeExtensionNode | InputObjectTypeExtensionNode

Type Extensions

TypeNode

TypeNode: NamedTypeNode | ListTypeNode | NonNullTypeNode

Type Reference

TypeSystemDefinitionNode

TypeSystemDefinitionNode: SchemaDefinitionNode | TypeDefinitionNode | DirectiveDefinitionNode

Type System Definition

TypeSystemExtensionNode

TypeSystemExtensionNode: SchemaExtensionNode | TypeExtensionNode

Type System Extensions

ValidationRule

ValidationRule: (context: ValidationContext) => ASTVisitor

Type declaration

ValueNode

ValueNode: VariableNode | IntValueNode | FloatValueNode | StringValueNode | BooleanValueNode | NullValueNode | EnumValueNode | ListValueNode | ObjectValueNode

Values

Variables

constDEFAULT_DEPRECATION_REASON

DEFAULT_DEPRECATION_REASON: No longer supported = 'No longer supported'

Constant string used for default reason for a deprecation.

constGRAPHQL_DIRECTIVE_SYMBOL

GRAPHQL_DIRECTIVE_SYMBOL: typeof GRAPHQL_DIRECTIVE_SYMBOL = ...

constGRAPHQL_ENUM_TYPE_SYMBOL

GRAPHQL_ENUM_TYPE_SYMBOL: typeof GRAPHQL_ENUM_TYPE_SYMBOL = ...

constGRAPHQL_INPUT_OBJECT_TYPE_SYMBOL

GRAPHQL_INPUT_OBJECT_TYPE_SYMBOL: typeof GRAPHQL_INPUT_OBJECT_TYPE_SYMBOL = ...

constGRAPHQL_INTERFACE_TYPE_SYMBOL

GRAPHQL_INTERFACE_TYPE_SYMBOL: typeof GRAPHQL_INTERFACE_TYPE_SYMBOL = ...

constGRAPHQL_LIST_TYPE_SYMBOL

GRAPHQL_LIST_TYPE_SYMBOL: typeof GRAPHQL_LIST_TYPE_SYMBOL = ...

constGRAPHQL_MAX_INT

GRAPHQL_MAX_INT: 2147483647 = 2147483647

Maximum possible Int value as per GraphQL Spec (32-bit signed integer). n.b. This differs from JavaScript’s numbers that are IEEE 754 doubles safe up-to 2^53 - 1

constGRAPHQL_MIN_INT

GRAPHQL_MIN_INT: -2147483648 = -2147483648

Minimum possible Int value as per GraphQL Spec (32-bit signed integer). n.b. This differs from JavaScript’s numbers that are IEEE 754 doubles safe starting at -(2^53 - 1)

constGRAPHQL_NON_NULL_TYPE_SYMBOL

GRAPHQL_NON_NULL_TYPE_SYMBOL: typeof GRAPHQL_NON_NULL_TYPE_SYMBOL = ...

constGRAPHQL_OBJECT_TYPE_SYMBOL

GRAPHQL_OBJECT_TYPE_SYMBOL: typeof GRAPHQL_OBJECT_TYPE_SYMBOL = ...

constGRAPHQL_SCALAR_TYPE_SYMBOL

GRAPHQL_SCALAR_TYPE_SYMBOL: typeof GRAPHQL_SCALAR_TYPE_SYMBOL = ...

constGRAPHQL_SCHEMA_SYMBOL

GRAPHQL_SCHEMA_SYMBOL: typeof GRAPHQL_SCHEMA_SYMBOL = ...

constGRAPHQL_SOURCE_SYMBOL

GRAPHQL_SOURCE_SYMBOL: typeof GRAPHQL_SOURCE_SYMBOL = ...

constGRAPHQL_UNION_TYPE_SYMBOL

GRAPHQL_UNION_TYPE_SYMBOL: typeof GRAPHQL_UNION_TYPE_SYMBOL = ...

constGRAPHQL_VERSION_SYMBOL

GRAPHQL_VERSION_SYMBOL: typeof GRAPHQL_VERSION_SYMBOL = ...

A symbol containing the version of the GraphQL.js library

constGraphQLBoolean

GraphQLBoolean: GraphQLScalarTypeImpl<boolean, boolean> = ...

constGraphQLDeprecatedDirective

GraphQLDeprecatedDirective: GraphQLDirective = ...

Used to declare element of a GraphQL schema as deprecated.

constGraphQLFloat

GraphQLFloat: GraphQLScalarTypeImpl<number, number> = ...

constGraphQLID

GraphQLID: GraphQLScalarTypeImpl<string, string> = ...

constGraphQLIncludeDirective

GraphQLIncludeDirective: GraphQLDirective = ...

Used to conditionally include fields or fragments.

constGraphQLInt

GraphQLInt: GraphQLScalarTypeImpl<number, number> = ...

constGraphQLSkipDirective

GraphQLSkipDirective: GraphQLDirective = ...

Used to conditionally skip (exclude) fields or fragments.

constGraphQLSpecifiedByDirective

GraphQLSpecifiedByDirective: GraphQLDirective = ...

Used to provide a URL for specifying the behavior of custom scalar definitions.

constGraphQLString

GraphQLString: GraphQLScalarTypeImpl<string, string> = ...

constSchemaMetaFieldDef

SchemaMetaFieldDef: GraphQLField<unknown, unknown> = ...

Note that these are GraphQLField and not GraphQLFieldConfig, so the format for args is different.

constTypeMetaFieldDef

TypeMetaFieldDef: GraphQLField<unknown, unknown> = ...

constTypeNameMetaFieldDef

TypeNameMetaFieldDef: GraphQLField<unknown, unknown> = ...

const__Directive

__Directive: GraphQLObjectType = ...

const__DirectiveLocation

__DirectiveLocation: GraphQLEnumType = ...

const__EnumValue

__EnumValue: GraphQLObjectType = ...

const__Field

__Field: GraphQLObjectType = ...

const__InputValue

__InputValue: GraphQLObjectType = ...

const__Schema

__Schema: GraphQLObjectType = ...

const__Type

__Type: GraphQLObjectType = ...

const__TypeKind

__TypeKind: GraphQLEnumType = ...

constintrospectionTypes

introspectionTypes: ReadonlyArray<GraphQLNamedType> = ...

constspecifiedDirectives

specifiedDirectives: ReadonlyArray<GraphQLDirective> = ...

The full list of specified directives.

constspecifiedRules

specifiedRules: ReadonlyArray<ValidationRule> = ...

This set includes all validation rules defined by the GraphQL spec.

The order of the rules in this list has been adjusted to lead to the most clear output when encountering multiple validation errors.

constspecifiedScalarTypes

specifiedScalarTypes: ReadonlyArray<GraphQLScalarType> = ...

constversion

version: string = ...

A string containing the version of the GraphQL.js library

constversionInfo

versionInfo: Readonly<{ major: number; minor: number; patch: number; preReleaseTag: null | string }> = ...

An object containing the components of the GraphQL.js version string