Struct gurkle::GraphQLError

pub struct GraphQLError {
    pub message: String,
    pub locations: Option<Vec<Location>>,
    pub path: Option<Vec<PathFragment>>,
    pub extensions: Option<HashMap<String, Value>>,
}

An element in the top-level errors array of a response body.

This tries to be as close to the spec as possible.

Spec

use gurkle::*;

let body: Response<ResponseData> = serde_json::from_value(json!({
    "data": null,
    "errors": [
        {
            "message": "The server crashed. Sorry.",
            "locations": [{ "line": 1, "column": 1 }]
        },
        {
            "message": "Seismic activity detected",
            "path": ["underground", 20]
        },
     ],
}))?;

let expected: Response<ResponseData> = Response {
    data: None,
    errors: Some(vec![
        GraphQLError {
            message: "The server crashed. Sorry.".to_owned(),
            locations: Some(vec![
                Location {
                    line: 1,
                    column: 1,
                }
            ]),
            path: None,
            extensions: None,
        },
        GraphQLError {
            message: "Seismic activity detected".to_owned(),
            locations: None,
            path: Some(vec![
                PathFragment::Key("underground".into()),
                PathFragment::Index(20),
            ]),
            extensions: None,
        },
    ]),
};

assert_eq!(body, expected);

Fields

message: String

The human-readable error message. This is the only required field.

locations: Option<Vec<Location>>

Which locations in the query the error applies to.

path: Option<Vec<PathFragment>>

Which path in the query the error applies to, e.g. ["users", 0, "email"].

extensions: Option<HashMap<String, Value>>

Additional errors. Their exact format is defined by the server.

Trait Implementations

impl Clone for GraphQLError

fn clone(&self) -> GraphQLError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GraphQLError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GraphQLError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for GraphQLError

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

Formats the value using the given formatter.

impl PartialEq<GraphQLError> for GraphQLError

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

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

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

This method tests for !=.

impl Serialize for GraphQLError

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GraphQLError