Struct graphql_client::Error

pub struct Error {
    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 graphql_client::*;

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![
        Error {
            message: "The server crashed. Sorry.".to_owned(),
            locations: Some(vec![
                Location {
                    line: 1,
                    column: 1,
                }
            ]),
            path: None,
            extensions: None,
        },
        Error {
            message: "Seismic activity detected".to_owned(),
            locations: None,
            path: Some(vec![
                PathFragment::Key("underground".into()),
                PathFragment::Index(20),
            ]),
            extensions: None,
        },
    ]),
    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 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<'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

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

Formats the value using the given formatter.

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