GraphQL：失败与错误处理-JavaScript中文网-JavaScript教程资源分享门户

GraphQL 是一种用于API 的查询语言和执行框架，它可以帮助前端工程师轻松地从服务器获取需要的数据。在前端开发中，GraphQL 更加优雅地处理了 API 的失败和错误响应。在本文中，我们将深入探讨 GraphQL 的失败和错误处理，介绍一些实用的技巧和方法。

GraphQL 的错误处理

GraphQL 的错误处理非常简单明了，一个 GraphQL 查询将会返回一个包含了错误信息的对象，如果没有错误则返回数据。对于错误处理，GraphQL 有两种类型：用户错误（User errors）和其他错误（Other errors）。当我们在应用中处理这些错误时，可以根据这两种类型对错误进行分类处理。

用户错误

如果请求的 GraphQL 查询缺失必要的参数或者包含不规范的数据，那么 GraphQL 将返回一个用户错误。用户错误的响应会有一个 errors 属性，里面包含一个数组，数组中的每个元素都是一个描述错误的对象。我们可以通过解析这些错误对象，轻松地将错误信息呈现给用户。

其他错误

如果出现了除用户错误之外的其他类型的错误，我们可以通过 GraphQL 服务的 formatError 函数来定制错误信息的返回格式。在这个函数中，我们可以将错误信息格式化为可读性更强的文本，同时也能够安全地移除敏感信息。

处理 GraphQL 的错误

在处理 GraphQL 的错误时，我们推荐使用一些最佳实践。这些实践可以最大程度地减少我们的工作量，同时对于处理错误问题也非常有效。以下是一些处理 GraphQL 错误的最佳实践：

使用 Apollo Client

使用 Apollo Client 是最佳实践之一。Apollo Client 是一个开箱即用、强大的 GraphQL 客户端，它在客户端上自动管理数据获取和缓存更新。除此之外，它还提供了一些很好的错误处理机制，比如 ErrorLink、onError 和 errorPolicy 等，可用于处理 API 服务端返回的错误。

例如，我们可以通过 onError 属性来捕获所有 Apollo 请求的任何非用户错误。通过这个属性，我们可以很容易地获取错误对象并将错误信息呈现给用户。

-- -------------------- ---- -------
-- ------ ------ -------------
----- ------ - --- --------------
  ---- -------------------------------------
  ------ --- ----------------
  -------- -- -------------- ------------ -- -- -
    -- --- ------
    -------------------------- --------------
 
    -- ------- - ------------ -- ----
    --------------------
  --
---

根据错误类型分类处理

在处理 GraphQL 的错误时，我们可以通过分类处理减轻我们的工作量。像上面提到的那样，GraphQL 可以根据类型来对错误进行分类，我们可以使用这些信息来针对不同的错误类型进行处理。举个例子，对于来自用户的错误，我们会根据规则将错误信息呈现给用户。

// Filter user errors from response errors
const userErrors = responseData.errors.filter(error => error.type === 'UserError');

// Display user errors on form
userErrors.forEach(({ message, path }) => {
  const formError = formErrors.find(error => error.path === path.join('.'));
  formError && (formError.message = message);
});

保留一些错误信息

在处理 GraphQL 的错误时，我们需要让用户了解所发生的错误情况，包括错误类型、原因和如何解决问题。同时，我们也需要具备数据隐私保护的能力。因此，我们可以在处理 GraphQL 错误时将错误信息简化，保留一些重要的部分，同时去除敏感或不必要的数据。

// Simply display errors for users
const message =
  graphQLError?.message ||
  'Sorry, something went wrong when fetching data. Please try again later.';

// Log for debugging
console.error(err);

结论

GraphQL 的错误处理非常简单明了，我们可以轻松地处理错误信息并将其展现给用户。在本文中，我们通过几个最佳实践，为读者提供了一些处理 GraphQL 错误的技巧和方法。我们推荐使用 Apollo Client 并根据错误类型分类处理错误信息，同时也需要保护数据隐私。

我们希望这篇文章能够对前端工程师们有所帮助，让您能够更加轻松地处理 GraphQL 错误。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/66f60a6dc5c563ced57ee755