Struct apollo_router::graphql::Error

#[non_exhaustive]
pub struct Error {
    pub message: String,
    pub locations: Vec<Location>,
    pub path: Option<Path>,
    pub extensions: Map<ByteString, Value>,
}

A GraphQL error as may be found in the errors field of a GraphQL Response.

Converted to (or from) JSON with serde.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

message: String

The error message.

locations: Vec<Location>

The locations of the error in the GraphQL document of the originating request.

path: Option<Path>

If this is a field error, the JSON path to that field in Response::data

extensions: Map<ByteString, Value>

The optional GraphQL extensions for this error.

Implementations

impl Error

pub fn builder<T: Into<String>>() -> NewErrorBuilder<T>

Returns a builder that builds a GraphQL Error from its components.

Builder methods:

• .message(impl Into<String>) Required. Sets Error::message.

• .locations(impl Into<Vec<Location>>) Optional. Sets the entire Vec of Error::locations, which defaults to the empty.

• .location(impl Into<Location>) Optional, may be called multiple times. Adds one item at the end of Error::locations.

• .path(impl Into<Path>) Optional. Sets Error::path.

• .extensions(impl Into<serde_json_bytes::Map<ByteString, Value>>) Optional. Sets the entire Error::extensions map, which defaults to empty.

• .extension(impl Into<ByteString>, impl Into<Value>) Optional, may be called multiple times. Adds one item to the Error::extensions map.

• .build() Finishes the builder and returns a GraphQL Error.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Error

fn default() -> Error

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Error

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Error

Displays (only) the error message.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<PlanError> for Error

fn from(err: PlanError) -> Self

Converts to this type from the input type.

impl From<PlannerError> for Error

fn from(err: PlannerError) -> Self

Converts to this type from the input type.

impl From<WorkerError> for Error

fn from(err: WorkerError) -> Self

Converts to this type from the input type.

impl From<WorkerGraphQLError> for Error

fn from(err: WorkerGraphQLError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Error

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Error

impl StructuralPartialEq for Error