@react-libraries/use-fetch v1.0.1

@react-libraries/useFetch

1. Description

Like useSWR, it caches the retrieved data. It is also possible to pass cache data from SSR.

2. usage

2.1. Basic

type fetchOption<T> = {
  fetch?: fetcherFn<T>; // Default: (key) => fetch(key).then((data) => data.json());
  initialData?: T;      // first data
  skip?: boolean;       // If 'true', execution will be skipped
};

useFetch<T>(key: string, options?: fetchOption<T>): {
    data?: T;
    dispatch: (data?: T) => void; //update cache
    isValidating: boolean;        //fetch in progress
    error: unknown;               //catch error
}

mutate<T>(key: string, value?: T | undefined) => void;
query<T>(key: string) => T;

//SSR
getDataFromTree(element: ReactElement) => Promise<CachesType>;
createCache(data: CachesType<unknown> | undefined) => void;

2.2. SSR

SSR can be done automatically by passing cache data as follows in Next.js.
Use'getDataFromTree' and 'createCache'.

_app.tsx

import { AppContext, AppProps } from 'next/app';
import { createCache, getDataFromTree, CacheType } from '@react-libraries/use-fetch';

const IS_SERVER = !process.browser;

const App = (props: AppProps & { cache: CacheType }) => {
  const { Component, cache } = props;
  !IS_SERVER && createCache(cache);
  return <Component />;
};
App.getInitialProps = async ({ Component, router, AppTree }: AppContext) => {
  const cache = IS_SERVER
    ? await getDataFromTree(<AppTree Component={Component} pageProps={{}} router={router} />)
    : {};
  return { cache };
};
export default App;

3. example

import { useFetch } from '@react-libraries/use-fetch';

export const Page = () => {
  const router = useRouter();
  const { data, error, isValidating, dispatch } = useFetch<DataType>(
    "URL"
  );
  return (
    <>
      <button onClick={dispatch()}>Reload</button>
      {isValidating && <div>Loading</div>}
      {error && <div>Error</div>}
      {data && <pre>{JSON.stringify(data,undefined,'  ')}</pre>}
    </>
  );
};