Apollo通过其API公开了两种错误:GraphQL errors,作为响应的一部分errors
与一起返回data
,以及在请求失败时发生的网络错误。当无法访问服务器或响应状态不是200时,将发生网络错误- errors
响应中的查询仍可以具有200状态。但是,例如,无效查询将导致400状态和Apollo Client中的网络错误。
Apollo Client实际上提供了四种不同的方法来处理突变错误:
1.)调用mutate
钩子返回的函数将返回一个Promise。如果请求成功,则Promise将解析为包含data
服务器返回的响应对象。如果请求失败,则Promise将拒绝并显示错误。这就是为什么您在控制台中看到“未处理的拒绝”消息的原因-您需要处理被拒绝的Promise。
login()
.then(({ data }) => {
// you can do something with the response here
})
.catch(e => {
// you can do something with the error here
})
或使用async / await语法:
try {
const { data } = await login()
} catch (e) {
// do something with the error here
}
默认情况下,承诺将拒绝对任何 GraphQL错误或网络错误。通过将errorPolicy设置为ignore
或all
,Promise将仅拒绝出现网络错误。在这种情况下,仍然可以通过响应对象访问GraphQL错误,但是Promise可以解决。
2)以上唯一的例外是在您提供onError
功能时发生的。在这种情况下,Promise始终会解决而不是拒绝,但是如果发生错误,onError
则会调用该错误并产生错误。在errorPolicy
这里也设置适用- onError
将永远被称为网络错误,但只用GraphQL错误使用默认时被调用errorPolicy
的none
。使用onError
等效于捕获被拒绝的Promise-它只是将错误处理程序从mutate
函数的调用位置移到挂钩的调用位置。
3.)除mutate
函数外,useMutation
钩子还返回结果对象。该对象还公开了运行突变时遇到的任何错误。与上面编写的错误处理程序函数不同,该error
对象表示应用程序状态。以这种方式公开的error
和data
对象都为方便起见而存在。它们等效于执行此操作:
const [mutate] = useMutation(YOUR_MUTATION)
const [data, setData] = useState()
const [error, setError] = useState()
const handleClick = async () => {
try {
const { data } = await mutate()
setData(data)
catch (e) {
setError(e)
}
}
当您希望UI反映出存在错误的事实时,具有这样的错误状态可能会很有用。例如,您可以更改元素的颜色,直到突变运行没有错误为止。不必自己编写上述样板文件,只需使用提供的结果对象即可。
const [mutate, { data, error }] = useMutation(YOUR_MUTATION)
注意:虽然您可以使用公开的错误状态来更新UI,但这不能代替实际处理错误。您必须提供onError
回调或catch
错误,以避免警告有关未处理的Promise拒绝。
4.)最后,您还可以使用apollo-link-error为您的请求添加全局错误处理。例如,这使您可以显示错误对话框,无论请求在应用程序中的何处发出。
在应用程序中使用哪种方法在很大程度上取决于您要执行的操作(全局与本地,状态与回调等)。大多数应用程序将使用不止一种错误处理方法。