solid-swr-store

SolidJS bindings for swr-store

Install

1npm install --save swr-store solid-swr-store

1yarn add swr-store solid-swr-store

Usage

1import { Suspense } from 'solid-js';
2import { createSWRStore } from 'swr-store';
3import { useSWRStore, useSWRStoreSuspenselesss } from 'solid-swr-store';
4
5const API = 'https://dog.ceo/api/breed/';
6const API_SUFFIX = '/images/random';
7
8interface APIResult {
9  message: string;
10  status: string;
11}
12
13const dogAPI = createSWRStore<APIResult, [string]>({
14  key: (breed: string) => breed,
15  get: async (breed: string) => {
16    const response = await fetch(`${API}${breed}${API_SUFFIX}`);
17    return (await response.json()) as APIResult;
18  },
19  revalidateOnFocus: true,
20  revalidateOnNetwork: true,
21});
22
23function DogImage(): JSX.Element {
24  const data = useSWRStore(dogAPI, ['shiba']);
25
26  return <img src={data().message} alt={data().message} />;
27}
28
29function DogImageSuspenseless(): JSX.Element {
30  const data = useSWRStoreSuspenseless(dogAPI, ['shiba']);
31
32  return () => {
33    const current = data();
34
35    if (current.status === 'pending') {
36      return <h1>Loading...</h1>;
37    }
38    if (current.status === 'failure') {
39      return <h1>Something went wrong.</h1>
40    }
41    return <img src={current.data.message} alt={current.data.message} />;
42  };
43}
44
45function Trigger(): JSX.Element {
46  return (
47    <button
48      type="button"
49      onClick={() => {
50        dogAPI.trigger(['shiba']);
51      }}
52    >
53      Trigger
54    </button>
55  );
56}
57
58export default function App(): JSX.Element {
59  return (
60    <>
61      <Trigger />
62      <div>
63        <Suspense fallback={<h1>Loading...</h1>}>
64          <DogImage />
65        </Suspense>
66        <DogImageSuspenseless />
67      </div>
68    </>
69  );
70}

API

useSWRStore(store, args, options)

Subscribes to an SWR store, passing args, which are received by the corresponding store for data-fetching and cache updates.

options has the following properties:

• initialData: Allows lazy hydration when reading the store. If the store does not have cache, initialData hydrates the cache and attempts a revalidation. If no initialData is provided, defaults to store's options.initialData.
• shouldRevalidate: If true, goes through the revalidation process when reading through the cache. Defaults to true.

useSWRStoreSuspenseless(store, args, options)

Has the same API as useSWRStore except that it doesn't suspend the reading component.

License

MIT © lxsmnsyc