Logo
Query Functions
Query FunctionsWyzwalacz Błędów w Odpowiedzi

Wyzwalacz Błędów w Odpowiedzi

Included in the “Power Extensions” bundle

Jawnie dodaje wpis błędu do odpowiedzi, aby wywołać niepowodzenie żądania GraphQL (gdy pole nie spełnia oczekiwanych warunków).

Opis

Ten moduł dodaje pola i dyrektywy do jawnego wyzwalania błędów oraz dodawania ostrzeżeń do odpowiedzi GraphQL.

Błędy

Globalne pole _fail i dyrektywa @fail, które dodają wpis do właściwości errors w odpowiedzi, są dodawane do schematu GraphQL.

query {
  _fail(message: "Some error")
  
  posts {
    featuredImage @fail(
      # condition: IS_NULL, \<= This is the default value
      message: "The post does not have a featured image"
    ) {
      id
      src
    }
  }
  
  users {
    name @fail(
      condition: IS_EMPTY,
      message: "The retrieved user does not have a name"
    )
  }
}

Oba mogą również przyjmować argument data, aby dostarczyć informacje kontekstowe w odpowiedzi błędu.

Te elementy schematu są przydatne do jawnego wskazania, że w wykonanym zapytaniu GraphQL wystąpił błąd, gdy taki błąd nie pojawia się w naturalnych okolicznościach.

Następnie, w naszej aplikacji po stronie klienta (np. JavaScript z konfiguracją headless), możemy sprawdzić, czy wpis errors istnieje i na tej podstawie przetworzyć odpowiedź GraphQL lub wyświetlić użytkownikowi komunikat o błędzie:

/**
 * If the response contains error(s), return a concatenated error message
 *
 * @param {Object} response A response object from the GraphQL server
 * @return {string|null} The error message or nothing
 */
const maybeGetErrorMessage = (response) => {
  if (response.errors && response.errors.length) {
    return sprintf(
      __(`The API produced the following error(s): "%s"`, 'gato-graphql'),
      response.errors.map(error => error.message).join( __('", "') )
    );
  }
  return null;
}
 
const maybeErrorMessage = maybeGetErrorMessage(response);
if (maybeErrorMessage) {
  // Show error to the user
  // ...
} else {
  // Process response
  // ...
}

Ostrzeżenia

Globalne pole _warn i dyrektywa @warn, które dodają wpis do właściwości warnings w odpowiedzi, są dodawane do schematu GraphQL:

query {
  _warn(message: "Some warning")
  
  posts {
    id
    featuredImage {
      id
      src
    }
    doesNotHaveFeaturedImage: _isNull(value: $__featuredImage)
      @passOnwards(as: "doesNotHaveFeaturedImage")
      @if(condition: $doesNotHaveFeaturedImage)
        @warn(message: "The post does not have a featured image")
  }
}

Oba mogą również przyjmować argument data, aby dostarczyć informacje kontekstowe w odpowiedzi ostrzeżenia.

Te elementy schematu są przydatne do wskazania, że mimo iż zapytanie zostało wykonane pomyślnie, jakiś warunek nie był oczekiwany.

Przykłady

Pobieranie wpisu z nieistniejącym ID zwróci naturalnie null. Jeśli musimy traktować ten warunek jako błąd, możemy użyć dyrektywy @fail:

query GetPost($id: ID!) {
  post(by:{id: $id})
    @fail(
      message: "There is no post with the provided ID"
      data: {
        id: $id
      }
    )
  {
    id
    title
  }
}

W połączeniu z rozszerzeniem Multiple Query Execution, możemy uzyskać te same wyniki używając _fail (zwróć uwagę, że operacja FailIfPostNotExists nie jest wykonywana, gdy $postExists jest true):

query GetPost($id: ID!) {
  post(by:{id: $id}) {
    id
    title
  }
  _notNull(value: $__post) @export(as: "postExists")
}
 
query FailIfPostNotExists($id: ID!)
  @skip(if: $postExists)
  @depends(on: "GetPost")
{
  errorMessage: _sprintf(
    string: "There is no post with ID '%s'",
    values: [$id]
  ) @remove
  _fail(
    message: $__errorMessage
    data: {
      id: $id
    }
  ) @remove
}

Możemy użyć _fail, aby upewnić się, że użytkownik z podanym adresem e-mail jeszcze nie istnieje:

query EnsureUserDoesNotExist($userEmail: Email!) {
  user( by: { email: $userEmail } ) {
    _fail(
      message: "User with given email already exists"
      data: {
        email: $userEmail
      }
    )
  }
}
 
mutation CreateUser($userData: JSONObject!)
  @depends(on: "EnsureUserDoesNotExist")
{
  # ...
}

Możemy również użyć _fail, aby sprawdzić, czy pobieranie danych z zewnętrznego API spowodowało błędy:

query ConnectToExternalGraphQLAPI($endpoint: String!, $query: String!) {
  externalData: _sendGraphQLHTTPRequest(
    input: {
      endpoint: $endpoint
      query: $query
    }
  ) @export(as: "externalData")
  _propertyIsSetInJSONObject(
    object: $__externalData
    by: {
      key: "errors"
    }
  ) @export(as: "endpointHasErrors")
}
 
query FailIfExternalAPIHasErrors($endpoint: String!)
  @include(if: $endpointHasErrors)
  @depends(on: "ConnectToExternalGraphQLAPI")
{
  errorMessage: _sprintf(
    string: "Connecting to endpoint %s produced errors",
    values: [$endpoint]
  ) @remove
  data: _objectProperty(
    object: $externalData,
    by: {
      key: "errors"
    }
  ) @remove
  _fail(
    message: $__errorMessage
    data: {
      endpoint: $endpoint
      endpointData: $__data
    }
  ) @remove
}
 
query GetExternalAPIData
  @skip(if: $endpointHasErrors)
  @depends(on: "ConnectToExternalGraphQLAPI")
{
  data: _objectProperty(
    object: $externalData,
    by: {
      key: "data"
    }
  )
}