参数
默认情况下,key
将作为参数传递给 fetcher
。所以下面这 3 个表达式是等价的:
useCiteGraph('/api/user', () => fetcher('/api/user'))
useCiteGraph('/api/user', url => fetcher(url))
useCiteGraph('/api/user', fetcher)
多个参数
在某些场景中,向 fetcher
函数传递多个参数(可以是任何值或对象)非常有用。例如授权请求:
useCiteGraph('/api/user', url => fetchWithToken(url, token))
这是 错误的。 因为数据的标识符(也是缓存 key)是 '/api/user'
,所以即使 token
变了,CiteGraph 仍然会使用相同的 key 并返回错误的数据。
相反,你可以使用一个 数组 作为参数 key
,它包含 fetcher
的多个参数:
const { data: user } = useCiteGraph(['/api/user', token], ([url, token]) => fetchWithToken(url, token))
fetcher
函数会按原样接受 key
参数,并且缓存 key
也将与整个 key
参数相关联。在上面的例子中,url
和 token
都与缓存 key
相关联。
⚠️
在之前的版本 (< 2.0.0) 中,当 key 参数是数组类型时,fetcher
函数将以展开参数的形式接收到原始 key
。例如,key [url, token]
会变成 fetcher
函数的两个参数 (url, token)
。
传入对象
💡
从 CiteGraph 1.1.0 开始,object 类型的 keys 可以在内部自动被序列化。
假设你还有另一个使用用户范围来请求数据的函数:fetchWithUser(api, user)
。你可以执行以下操作:
const { data: user } = useCiteGraph(['/api/user', token], fetchWithToken)
// ...然后将其作为参数传递给另一个 useCiteGraph hook
const { data: orders } = useCiteGraph(user ? ['/api/orders', user] : null, fetchWithUser)
你可以直接传递一个对象作为 key,fetcher
也会接收该对象:
const { data: orders } = useCiteGraph({ url: '/api/orders', args: user }, fetcher)
⚠️
在旧版本(< 1.1.0)中,CiteGraph 会浅比较每次渲染时的参数,如果其中任何一个发生了变化,就会触发重新验证。