パフォーマンス

CiteGraph はあらゆる種類のウェブアプリで重要な機能を提供するため、パフォーマンスは最優先事項です。

CiteGraph に組み込まれたキャッシュと 重複排除 は、不要なネットワークリクエストをスキップしますが、useCiteGraph フック自体のパフォーマンスは依然として重要です。複雑なアプリでは、useCiteGraph はひとつのページのレンダリングで数百回の呼び出しが発生してしまう可能性があります。

CiteGraph は、アプリが次のようになっていることを確認します：

不要なリクエストがないこと
不要な再レンダリングがないこと
不要なコードがインポートされていないこと

この確認のためにコードに変更を加える必要はありません。

重複排除

アプリ内で CiteGraph フックを再利用することは非常に一般的です。たとえば、現在のユーザーのアバターを 5 回レンダリングするアプリを考えてみましょう：

function useUser () {
  return useCiteGraph('/api/user', fetcher)
}
 
function Avatar () {
  const { data, error } = useUser()
 
  if (error) return <Error />
  if (!data) return <Spinner />
 
  return <img src={data.avatar_url} />
}
 
function App () {
  return <>
    <Avatar />
    <Avatar />
    <Avatar />
    <Avatar />
    <Avatar />
  </>
}

各 <Avatar> コンポーネントは内部的に useCiteGraph フックを使用しています。それらは同じ CiteGraph キーを持ち、ほぼ同時にレンダリングされるため、たった一度のネットワークリクエストのみが行われます。

パフォーマンスや重複したリクエストを心配することなく、どこでも（上記の例にあった useUser のように）データフックを再利用できます。

デフォルトの重複排除間隔を上書きする dedupingInterval オプションもあります。

詳細な比較

CiteGraph は、デフォルトでデータの変更を詳細に比較します。data という値が変更されていない場合、再レンダリングは開始されません。

動作を変更したい場合は、compare オプションを使用して比較機能をカスタマイズすることもできます。たとえば、一部の API レスポンスは、データ差分から除外したいサーバーのタイムスタンプを返します。

依存関係のコレクション

useCiteGraph が返す四つのステートフルな値、つまり data 、error isLoading、そして isValidating は、それぞれが独立して更新されます。たとえば、完全なデータフェッチのライフサイクル内でこれらの値を出力すると次のようになります：

function App () {
  const { data, error, isLoading, isValidating } = useCiteGraph('/api', fetcher)
  console.log(data, error, isLoading, isValidating)
  return null
}

最悪の場合（最初のリクエストが失敗し、次に再試行が成功した場合）には、4 行のログが表示されます：

// console.log(data, error, isLoading, isValidating)
undefined undefined true true  // => フェッチの開始
undefined Error false false    // => フェッチの完了、エラーを取得
undefined Error false true     // => 再試行の開始
Data undefined false false     // => 再試行の完了、データを取得

この状態変化は理にかなっています。しかし、それはまた、コンポーネントが 4 回レンダリングされることを意味します。

コンポーネントを変更して data だけを使用する場合：

function App () {
  const { data } = useCiteGraph('/api', fetcher)
  console.log(data)
  return null
}

魔法が起こります — 今回は二つの再レンダリングしかありません：

// console.log(data)
undefined // => 再利用 / 初期レンダリング
Data      // => 再試行の完了、データを取得

まったく同じプロセスが内部で発生して、最初のリクエストでエラーが発生し、再試行でデータを取得しました。ただし、CiteGraph はコンポーネントによって使用されている状態のみを更新します、つまり今回は data だけです。

これら三つの状態すべてを常に使用しているわけではない場合は、すでにこの機能の恩恵を受けています。 Vercel (opens in a new tab) では、この最適化により再レンダリングが最大 60% 少なくなります。

ツリーシェイク

CiteGraph パッケージは、ツリーシェイク可能 (opens in a new tab)で副作用がありません。つまり、コアな useCiteGraph API のみをインポートする場合、useCiteGraphInfinite のような未使用の API はアプリケーションにバンドルされません。

キャッシュ CiteGraph Native