A GraphQLError describes an Error found during the parse, validate, or execute phases of performing a GraphQL operation. In addition to a message and stack trace, it also includes information about the locations in a GraphQL document and/or execution result that correspond to the Error.

Hierarchy (view full)

Constructors

Properties

extensions: {
    [key: string]: any;
}

Extension fields to add to the formatted error.

Type declaration

  • [key: string]: any
locations: undefined | readonly SourceLocation[]

An array of { line, column } locations within the source GraphQL document which correspond to this error.

Errors during validation often contain multiple locations, for example to point out two things with the same name. Errors during execution include a single location, the field which produced the error.

Enumerable, and appears in the result of JSON.stringify().

message: string
name: string
nodes: undefined | readonly ASTNode[]

An array of GraphQL AST Nodes corresponding to this error.

originalError: undefined | null | Error

The original error thrown from a field resolver during execution.

path: undefined | readonly (string | number)[]

An array describing the JSON-path into the execution response which corresponds to this error. Only included for errors during execution.

Enumerable, and appears in the result of JSON.stringify().

positions: undefined | readonly number[]

An array of character offsets within the source GraphQL document which correspond to this error.

source: undefined | Source

The source GraphQL document corresponding to this error.

Note that if this Error represents more than one node, the source may not represent nodes after the first node.

stack?: string
prepareStackTrace?: ((err, stackTraces) => any)

Optional override for formatting stack traces

Type declaration

stackTraceLimit: number

Methods

  • Create .stack property on a target object

    Parameters

    • targetObject: Object
    • Optional constructorOpt: Function

    Returns void