React, React Native కోసం స్టేట్ · 1.0

స్టేట్‌ను పంచుకోండి.ఒకే హుక్.అయిపోయింది.

ఒకే లైన్‌లో స్టోర్‌ను ప్రకటించి, Provider, action, reducer లేకుండా ఏ కాంపోనెంట్‌లోనైనా వాడండి. ఒక కాంపోనెంట్ తాను ఎంచుకున్న విలువ మారినప్పుడే మళ్లీ రెండర్ అవుతుంది; సేవ్ మీరు నిర్ణయించినప్పుడు జరుగుతుంది.

Terminal
npm install @kkwaenggwari/restate

లైవ్ — నిజమైన restate స్టోర్

useCart.set(cart => ({ ...cart, items: cart.items + 1, total: cart.total + 12 }))

items, total మారతాయి: మూడు కార్డ్‌లు రెండర్ అవుతాయి, గిఫ్ట్ కార్డ్ కదలకుండా ఉంటుంది.

01 — సులభం

అదే ఫీచర్, తక్కువ భావనలు.

ఒకే పనికి నాలుగు అమలులు పక్కపక్కనే. సంఖ్యలు ఇక్కడ చూపిన కోడ్ నుండి వస్తాయి; ఈ సైట్ build అయినప్పుడు కొలవబడతాయి.

పంచుకున్న కౌంటర్

రెండు కాంపోనెంట్లు ఒకే సంఖ్యను చదివి నవీకరిస్తాయి.

Redux Toolkit నవీకరణలను slice-లు, action-లుగా ఏర్పాటు చేసి, React context ద్వారా అందించిన స్టోర్‌కు పంపుతుంది. అద్భుతమైన DevTools, పెద్ద బృందాలకు కఠినమైన, ఊహించదగిన నవీకరణ ప్రవాహం.

Zustand create()‌తో స్టోర్ హుక్ సృష్టించి setState‌తో మారుస్తుంది. చాలా చిన్నది, సరళమైనది; persistence, DevTools కోసం middleware‌తో.

Jotai atom-లను, ఉత్పన్న atom-లను కలుపుతుంది, ఐచ్ఛికంగా Provider లోపల. అనేక చిన్న స్టేట్ ముక్కల మధ్య సూక్ష్మమైన ఆధారాలు.

Redux Toolkit29 లైన్లు · 5 API
JavaScript / JSX
import { configureStore, createSlice } from '@reduxjs/toolkit';
import { Provider, useDispatch, useSelector } from 'react-redux';

const slice = createSlice({
  name: 'count',
  initialState: 0,
  reducers: { increment: (count) => count + 1 },
});
const store = configureStore({
  reducer: { count: slice.reducer },
});

function Counter() {
  const count = useSelector((state) => state.count);
  const dispatch = useDispatch();
  return <button onClick={() => dispatch(slice.actions.increment())}>{count}</button>;
}

export default function App() {
  return (
    <Provider store={store}>
      <Counter />
      <Counter />
    </Provider>
  );
}
Zustand16 లైన్లు · 1 API
JavaScript / JSX
import { create } from 'zustand';

const useCount = create(() => ({ count: 0 }));
const increment = () =>
  useCount.setState((s) => ({
    count: s.count + 1,
  }));

function Counter() {
  const count = useCount((s) => s.count);
  return <button onClick={increment}>{count}</button>;
}

export default function App() {
  return (
    <>
      <Counter />
      <Counter />
    </>
  );
}
Jotai13 లైన్లు · 2 API
JavaScript / JSX
import { atom, useAtom } from 'jotai';

const countAtom = atom(0);

function Counter() {
  const [count, setCount] = useAtom(countAtom);
  return <button onClick={() => setCount((n) => n + 1)}>{count}</button>;
}

export default function App() {
  return (
    <>
      <Counter />
      <Counter />
    </>
  );
}

restate ఒకే డిక్లరేషన్ స్టోర్, హుక్ రెండూ అవుతుంది.

restate13 లైన్లు · 1 API
JavaScript / JSX
import { restate } from '@kkwaenggwari/restate';

const useCount = restate(0);

function Counter() {
  const count = useCount();
  return <button onClick={() => useCount.set((n) => n + 1)}>{count}</button>;
}

export default function App() {
  return (
    <>
      <Counter />
      <Counter />
    </>
  );
}

ఈ పనికి Zustand, Jotai కూడా చిన్నవి, Provider అవసరం లేనివి. సేవ్, ప్రతి పత్రానికి స్టేట్ జోడించినప్పుడు తేడా పెరుగుతుంది.

ఫీల్డ్‌ను ఎంచుకోవడం

టెక్స్ట్ మాత్రమే మారినప్పుడు శీర్షిక కాంపోనెంట్ రెండర్ కాకూడదు.

Redux Toolkit నవీకరణలను slice-లు, action-లుగా ఏర్పాటు చేసి, React context ద్వారా అందించిన స్టోర్‌కు పంపుతుంది. అద్భుతమైన DevTools, పెద్ద బృందాలకు కఠినమైన, ఊహించదగిన నవీకరణ ప్రవాహం.

Zustand create()‌తో స్టోర్ హుక్ సృష్టించి setState‌తో మారుస్తుంది. చాలా చిన్నది, సరళమైనది; persistence, DevTools కోసం middleware‌తో.

Jotai atom-లను, ఉత్పన్న atom-లను కలుపుతుంది, ఐచ్ఛికంగా Provider లోపల. అనేక చిన్న స్టేట్ ముక్కల మధ్య సూక్ష్మమైన ఆధారాలు.

Redux Toolkit26 లైన్లు · 4 API
JavaScript / JSX
import { configureStore, createSlice } from '@reduxjs/toolkit';
import { Provider, useSelector } from 'react-redux';

const article = createSlice({
  name: 'article',
  initialState: { title: 'Hello', body: '' },
  reducers: {
    editBody: (i) => {
      i.body += '!';
    },
    editTitle: (i) => {
      i.title += '!';
    },
  },
});
const store = configureStore({ reducer: article.reducer });

function Title() {
  const title = useSelector((i) => i.title);
  return <h3>{title}</h3>;
}

export default function App() {
  return (
    <Provider store={store}>
      <Title />
      <button onClick={() => store.dispatch(article.actions.editBody())}>body + !</button>
      <button onClick={() => store.dispatch(article.actions.editTitle())}>title + !</button>
    </Provider>
  );
}
Zustand17 లైన్లు · 1 API
JavaScript / JSX
import { create } from 'zustand';

const useArticle = create(() => ({ title: 'Hello', body: '' }));

function Title() {
  const title = useArticle((i) => i.title);
  return <h3>{title}</h3>;
}

export default function App() {
  return (
    <>
      <Title />
      <button
        onClick={() =>
          useArticle.setState((i) => ({
            body: i.body + '!',
          }))
        }
      >
        body + !
      </button>
      <button
        onClick={() =>
          useArticle.setState((i) => ({
            title: i.title + '!',
          }))
        }
      >
        title + !
      </button>
    </>
  );
}
Jotai19 లైన్లు · 3 API
JavaScript / JSX
import { atom, useAtomValue, useSetAtom } from 'jotai';

const articleAtom = atom({ title: 'Hello', body: '' });
const titleAtom = atom((get) => get(articleAtom).title);

function Title() {
  const title = useAtomValue(titleAtom);
  return <h3>{title}</h3>;
}

export default function App() {
  const setArticle = useSetAtom(articleAtom);
  return (
    <>
      <Title />
      <button
        onClick={() =>
          setArticle((i) => ({
            ...i,
            body: i.body + '!',
          }))
        }
      >
        body + !
      </button>
      <button
        onClick={() =>
          setArticle((i) => ({
            ...i,
            title: i.title + '!',
          }))
        }
      >
        title + !
      </button>
    </>
  );
}

restate మీరు ఇప్పటికే వాడుతున్న అదే హుక్‌కు selector ఇవ్వండి.

restate17 లైన్లు · 1 API
JavaScript / JSX
import { restate } from '@kkwaenggwari/restate';

const useArticle = restate({ title: 'Hello', body: '' });

function Title() {
  const title = useArticle((i) => i.title);
  return <h3>{title}</h3>;
}

export default function App() {
  return (
    <>
      <Title />
      <button
        onClick={() =>
          useArticle.set((i) => ({
            ...i,
            body: i.body + '!',
          }))
        }
      >
        body + !
      </button>
      <button
        onClick={() =>
          useArticle.set((i) => ({
            ...i,
            title: i.title + '!',
          }))
        }
      >
        title + !
      </button>
    </>
  );
}

ఇక్కడి అన్ని సాధనాలూ ఎంచుకోగలవు. restate ప్రత్యేక selector హుక్ లేదా ఉత్పన్న atom బదులు అదే హుక్ కాల్‌ను వాడుతుంది.

డ్రాఫ్ట్ సేవ్ చేయడం

ప్రారంభంలో సేవ్ చేసిన డ్రాఫ్ట్‌ను పునరుద్ధరించి, క్లిక్‌పై సేవ్ చేసి, సేవ్ అవుతోంది, సేవ్ కాలేదు, విఫలమైంది స్థితులను చూపించండి.

Redux Toolkit నవీకరణలను slice-లు, action-లుగా ఏర్పాటు చేసి, React context ద్వారా అందించిన స్టోర్‌కు పంపుతుంది. అద్భుతమైన DevTools, పెద్ద బృందాలకు కఠినమైన, ఊహించదగిన నవీకరణ ప్రవాహం.

Zustand create()‌తో స్టోర్ హుక్ సృష్టించి setState‌తో మారుస్తుంది. చాలా చిన్నది, సరళమైనది; persistence, DevTools కోసం middleware‌తో.

Jotai atom-లను, ఉత్పన్న atom-లను కలుపుతుంది, ఐచ్ఛికంగా Provider లోపల. అనేక చిన్న స్టేట్ ముక్కల మధ్య సూక్ష్మమైన ఆధారాలు.

Redux Toolkit84 లైన్లు · 4 API
JavaScript / JSX
import { useEffect, useState } from 'react';
import { configureStore, createSlice } from '@reduxjs/toolkit';
import { Provider, useSelector } from 'react-redux';

function openDraftDB() {
  return new Promise((resolve, reject) => {
    const request = indexedDB.open('draft-example', 1);
    let blocked = false;
    request.onupgradeneeded = () => {
      request.result.createObjectStore('drafts');
    };
    request.onblocked = () => {
      blocked = true;
      reject(new Error('Close other tabs to upgrade storage'));
    };
    request.onerror = () => reject(request.error);
    request.onsuccess = () => {
      const db = request.result;
      if (blocked) {
        db.close();
        return;
      }
      db.onversionchange = () => db.close();
      resolve(db);
    };
  });
}

async function storedDraft(mode, text) {
  const db = await openDraftDB();
  try {
    return await new Promise((resolve, reject) => {
      const tx = db.transaction('drafts', mode);
      const store = tx.objectStore('drafts');
      const request = mode === 'readonly' ? store.get('draft') : store.put(text, 'draft');
      tx.oncomplete = () => resolve(request.result);
      tx.onabort = () => reject(tx.error || new Error('Storage aborted'));
    });
  } finally {
    db.close();
  }
}

const draft = createSlice({
  name: 'draft',
  initialState: '',
  reducers: { edit: (_, action) => action.payload },
});
const store = configureStore({ reducer: { draft: draft.reducer } });
const hydrated = storedDraft('readonly').then((saved) => {
  if (saved === undefined) return;
  if (typeof saved !== 'string') throw new Error('Invalid draft');
  const value = saved;
  store.dispatch(draft.actions.edit(value));
});
// Observe errors immediately, even before the component mounts.
hydrated.catch(() => {});

function DraftEditor() {
  const text = useSelector((state) => state.draft);
  const [ready, setReady] = useState(false);
  const [saving, setSaving] = useState(false);
  const [message, setMessage] = useState('Loading');
  useEffect(() => {
    let active = true;
    hydrated.then(
      () => {
        if (active) {
          setReady(true);
          setMessage('Ready');
        }
      },
      () => {
        if (active) setMessage('Storage error');
      },
    );
    return () => {
      active = false;
    };
  }, []);
  async function save() {
    setSaving(true);
    try {
      await storedDraft('readwrite', store.getState().draft);
      setMessage('Saved');
    } catch {
      setMessage('Save failed');
    } finally {
      setSaving(false);
    }
  }
  return (
    <>
      <label>
        Draft
        <textarea
          value={text}
          disabled={!ready || saving}
          onChange={(event) => {
            const value = event.target.value;
            store.dispatch(draft.actions.edit(value));
            setMessage('Edited');
          }}
        />
      </label>
      <output>{text}</output>
      <button disabled={!ready || saving} onClick={save}>
        Save
      </button>
      <p>{message}</p>
    </>
  );
}

export default function App() {
  return (
    <Provider store={store}>
      <DraftEditor />
    </Provider>
  );
}
Zustand79 లైన్లు · 1 API
JavaScript / JSX
import { useEffect, useState } from 'react';
import { create } from 'zustand';

function openDraftDB() {
  return new Promise((resolve, reject) => {
    const request = indexedDB.open('draft-example', 1);
    let blocked = false;
    request.onupgradeneeded = () => {
      request.result.createObjectStore('drafts');
    };
    request.onblocked = () => {
      blocked = true;
      reject(new Error('Close other tabs to upgrade storage'));
    };
    request.onerror = () => reject(request.error);
    request.onsuccess = () => {
      const db = request.result;
      if (blocked) {
        db.close();
        return;
      }
      db.onversionchange = () => db.close();
      resolve(db);
    };
  });
}

async function storedDraft(mode, text) {
  const db = await openDraftDB();
  try {
    return await new Promise((resolve, reject) => {
      const tx = db.transaction('drafts', mode);
      const store = tx.objectStore('drafts');
      const request = mode === 'readonly' ? store.get('draft') : store.put(text, 'draft');
      tx.oncomplete = () => resolve(request.result);
      tx.onabort = () => reject(tx.error || new Error('Storage aborted'));
    });
  } finally {
    db.close();
  }
}

const useDraft = create(() => ({ text: '' }));
const hydrated = storedDraft('readonly').then((saved) => {
  if (saved === undefined) return;
  if (typeof saved !== 'string') throw new Error('Invalid draft');
  const value = saved;
  useDraft.setState({ text: value });
});
// Observe errors immediately, even before the component mounts.
hydrated.catch(() => {});

function DraftEditor() {
  const text = useDraft((state) => state.text);
  const [ready, setReady] = useState(false);
  const [saving, setSaving] = useState(false);
  const [message, setMessage] = useState('Loading');
  useEffect(() => {
    let active = true;
    hydrated.then(
      () => {
        if (active) {
          setReady(true);
          setMessage('Ready');
        }
      },
      () => {
        if (active) setMessage('Storage error');
      },
    );
    return () => {
      active = false;
    };
  }, []);
  async function save() {
    setSaving(true);
    try {
      await storedDraft('readwrite', useDraft.getState().text);
      setMessage('Saved');
    } catch {
      setMessage('Save failed');
    } finally {
      setSaving(false);
    }
  }
  return (
    <>
      <label>
        Draft
        <textarea
          value={text}
          disabled={!ready || saving}
          onChange={(event) => {
            const value = event.target.value;
            useDraft.setState({ text: value });
            setMessage('Edited');
          }}
        />
      </label>
      <output>{text}</output>
      <button disabled={!ready || saving} onClick={save}>
        Save
      </button>
      <p>{message}</p>
    </>
  );
}

export default function App() {
  return <DraftEditor />;
}
Jotai80 లైన్లు · 3 API
JavaScript / JSX
import { useEffect, useState } from 'react';
import { atom, createStore, useAtomValue } from 'jotai';

function openDraftDB() {
  return new Promise((resolve, reject) => {
    const request = indexedDB.open('draft-example', 1);
    let blocked = false;
    request.onupgradeneeded = () => {
      request.result.createObjectStore('drafts');
    };
    request.onblocked = () => {
      blocked = true;
      reject(new Error('Close other tabs to upgrade storage'));
    };
    request.onerror = () => reject(request.error);
    request.onsuccess = () => {
      const db = request.result;
      if (blocked) {
        db.close();
        return;
      }
      db.onversionchange = () => db.close();
      resolve(db);
    };
  });
}

async function storedDraft(mode, text) {
  const db = await openDraftDB();
  try {
    return await new Promise((resolve, reject) => {
      const tx = db.transaction('drafts', mode);
      const store = tx.objectStore('drafts');
      const request = mode === 'readonly' ? store.get('draft') : store.put(text, 'draft');
      tx.oncomplete = () => resolve(request.result);
      tx.onabort = () => reject(tx.error || new Error('Storage aborted'));
    });
  } finally {
    db.close();
  }
}

const draftAtom = atom('');
const store = createStore();
const hydrated = storedDraft('readonly').then((saved) => {
  if (saved === undefined) return;
  if (typeof saved !== 'string') throw new Error('Invalid draft');
  const value = saved;
  store.set(draftAtom, value);
});
// Observe errors immediately, even before the component mounts.
hydrated.catch(() => {});

function DraftEditor() {
  const text = useAtomValue(draftAtom, { store });
  const [ready, setReady] = useState(false);
  const [saving, setSaving] = useState(false);
  const [message, setMessage] = useState('Loading');
  useEffect(() => {
    let active = true;
    hydrated.then(
      () => {
        if (active) {
          setReady(true);
          setMessage('Ready');
        }
      },
      () => {
        if (active) setMessage('Storage error');
      },
    );
    return () => {
      active = false;
    };
  }, []);
  async function save() {
    setSaving(true);
    try {
      await storedDraft('readwrite', store.get(draftAtom));
      setMessage('Saved');
    } catch {
      setMessage('Save failed');
    } finally {
      setSaving(false);
    }
  }
  return (
    <>
      <label>
        Draft
        <textarea
          value={text}
          disabled={!ready || saving}
          onChange={(event) => {
            const value = event.target.value;
            store.set(draftAtom, value);
            setMessage('Edited');
          }}
        />
      </label>
      <output>{text}</output>
      <button disabled={!ready || saving} onClick={save}>
        Save
      </button>
      <p>{message}</p>
    </>
  );
}

export default function App() {
  return <DraftEditor />;
}

restate persistedRestate స్వయంచాలకంగా పునరుద్ధరిస్తుంది; useStatus సేవ్, సేవ్ కాని మార్పులు, లోపాలను నివేదిస్తుంది.

restate18 లైన్లు · 1 API
JavaScript / JSX
import { persistedRestate } from '@kkwaenggwari/restate';

const useDraft = persistedRestate('', {
  key: 'draft',
  validate: (value) => typeof value === 'string',
});

export default function App() {
  const text = useDraft();
  const { dirty, operation, error } = useDraft.useStatus();
  const saving = operation === 'save';
  const message = error ? 'Save failed' : saving ? 'Saving…' : dirty ? 'Edited' : 'Saved';

  return (
    <>
      <label>
        Draft
        <textarea value={text} onChange={(event) => useDraft.set(event.target.value)} />
      </label>
      <output>{text}</output>
      <button disabled={saving} onClick={() => useDraft.save().catch(() => {})}>
        Save
      </button>
      <p>{message}</p>
    </>
  );
}

ఇతర వెర్షన్‌లు అదే IndexedDB కోడ్‌ను చేతితో రాస్తాయి. వాటి persistence middleware లేదా స్టోరేజ్ యుటిలిటీలు అడాప్టర్‌తో దాన్ని తగ్గించవచ్చు; ఆ కోడ్ ఇక్కడ లెక్కలో లేదు.

ప్రతి పత్రానికి స్టేట్

రెండు పత్రాలు వేర్వేరు స్టేట్‌ను ఉంచుకుంటాయి; ఒకదాన్ని మూసివేస్తే అది విడుదల అవుతుంది.

Redux Toolkit నవీకరణలను slice-లు, action-లుగా ఏర్పాటు చేసి, React context ద్వారా అందించిన స్టోర్‌కు పంపుతుంది. అద్భుతమైన DevTools, పెద్ద బృందాలకు కఠినమైన, ఊహించదగిన నవీకరణ ప్రవాహం.

Zustand create()‌తో స్టోర్ హుక్ సృష్టించి setState‌తో మారుస్తుంది. చాలా చిన్నది, సరళమైనది; persistence, DevTools కోసం middleware‌తో.

Jotai atom-లను, ఉత్పన్న atom-లను కలుపుతుంది, ఐచ్ఛికంగా Provider లోపల. అనేక చిన్న స్టేట్ ముక్కల మధ్య సూక్ష్మమైన ఆధారాలు.

Redux Toolkit42 లైన్లు · 4 API
JavaScript / JSX
import { useState } from 'react';
import { configureStore, createSlice } from '@reduxjs/toolkit';
import { Provider, useSelector } from 'react-redux';

const draft = createSlice({
  name: 'draft',
  initialState: '',
  reducers: { edit: (_, action) => action.payload },
});
const selectionSlice = createSlice({
  name: 'selection',
  initialState: 0,
  reducers: { next: (index) => index + 1 },
});
function createDocument() {
  return {
    store: configureStore({
      reducer: {
        draft: draft.reducer,
        selection: selectionSlice.reducer,
      },
    }),
  };
}

function Document({ doc, name }) {
  const text = useSelector((state) => state.draft);
  const selection = useSelector((state) => state.selection);
  return (
    <section>
      <label>
        {name}
        <input
          value={text}
          onChange={(event) => doc.store.dispatch(draft.actions.edit(event.target.value))}
        />
      </label>
      <output>{text}</output>
      <button onClick={() => doc.store.dispatch(selectionSlice.actions.next())}>
        Selection: {selection}
      </button>
    </section>
  );
}

function DocumentSlot({ name }) {
  const [doc] = useState(createDocument);
  return (
    <Provider store={doc.store}>
      <Document doc={doc} name={name} />
    </Provider>
  );
}

export default function App() {
  const [leftOpen, setLeftOpen] = useState(true);
  return (
    <>
      <button onClick={() => setLeftOpen((open) => !open)}>
        {leftOpen ? 'Close left' : 'Open left'}
      </button>
      {leftOpen && <DocumentSlot name="Left" />}
      <DocumentSlot name="Right" />
    </>
  );
}
Zustand35 లైన్లు · 2 API
JavaScript / JSX
import { useState } from 'react';
import { useStore } from 'zustand';
import { createStore } from 'zustand/vanilla';

function createDocument() {
  return {
    draft: createStore(() => ({ text: '' })),
    selection: createStore(() => ({ index: 0 })),
  };
}

function Document({ doc, name }) {
  const text = useStore(doc.draft, (state) => state.text);
  const selection = useStore(doc.selection, (state) => state.index);
  return (
    <section>
      <label>
        {name}
        <input
          value={text}
          onChange={(event) => doc.draft.setState({ text: event.target.value })}
        />
      </label>
      <output>{text}</output>
      <button onClick={() => doc.selection.setState((s) => ({ index: s.index + 1 }))}>
        Selection: {selection}
      </button>
    </section>
  );
}

function DocumentSlot({ name }) {
  const [doc] = useState(createDocument);
  return <Document doc={doc} name={name} />;
}

export default function App() {
  const [leftOpen, setLeftOpen] = useState(true);
  return (
    <>
      <button onClick={() => setLeftOpen((open) => !open)}>
        {leftOpen ? 'Close left' : 'Open left'}
      </button>
      {leftOpen && <DocumentSlot name="Left" />}
      <DocumentSlot name="Right" />
    </>
  );
}
Jotai33 లైన్లు · 3 API
JavaScript / JSX
import { useState } from 'react';
import { atom, createStore, useAtomValue } from 'jotai';

const draftAtom = atom('');
const selectionAtom = atom(0);
function createDocument() {
  return { store: createStore() };
}

function Document({ doc, name }) {
  const text = useAtomValue(draftAtom, { store: doc.store });
  const selection = useAtomValue(selectionAtom, { store: doc.store });
  return (
    <section>
      <label>
        {name}
        <input value={text} onChange={(event) => doc.store.set(draftAtom, event.target.value)} />
      </label>
      <output>{text}</output>
      <button onClick={() => doc.store.set(selectionAtom, (n) => n + 1)}>
        Selection: {selection}
      </button>
    </section>
  );
}

function DocumentSlot({ name }) {
  const [doc] = useState(createDocument);
  return <Document doc={doc} name={name} />;
}

export default function App() {
  const [leftOpen, setLeftOpen] = useState(true);
  return (
    <>
      <button onClick={() => setLeftOpen((open) => !open)}>
        {leftOpen ? 'Close left' : 'Open left'}
      </button>
      {leftOpen && <DocumentSlot name="Left" />}
      <DocumentSlot name="Right" />
    </>
  );
}

restate useRestateScope స్టోర్‌లను సృష్టించి, అన్‌మౌంట్ తర్వాత నాశనం చేస్తుంది.

restate27 లైన్లు · 2 API
JavaScript / JSX
import { useState } from 'react';
import { restate, useRestateScope } from '@kkwaenggwari/restate';

function Document({ name }) {
  const doc = useRestateScope((scope) => ({
    useDraft: restate('', { scope }),
    useSelection: restate(0, { scope }),
  }));
  const text = doc.useDraft();
  const selection = doc.useSelection();
  return (
    <section>
      <label>
        {name}
        <input value={text} onChange={(event) => doc.useDraft.set(event.target.value)} />
      </label>
      <output>{text}</output>
      <button onClick={() => doc.useSelection.set((n) => n + 1)}>Selection: {selection}</button>
    </section>
  );
}

export default function App() {
  const [leftOpen, setLeftOpen] = useState(true);
  return (
    <>
      <button onClick={() => setLeftOpen((open) => !open)}>
        {leftOpen ? 'Close left' : 'Open left'}
      </button>
      {leftOpen && <Document name="Left" />}
      <Document name="Right" />
    </>
  );
}

Jotai-లో Provider లేదా store, Zustand-లో vanilla store-లు స్టేట్‌ను వేరుచేయగలవు; వాటిని మీరే సృష్టించి కనెక్ట్ చేస్తారు.

ఈ సంఖ్యలు ఎలా లెక్కించబడతాయి

చూపిన కోడ్‌లోని ఖాళీ కాని లైన్లు, ప్రతి స్టేట్ లైబ్రరీ నుండి import చేసిన పేర్లు (React import-లు లెక్కలో లేవు). ప్రతి వెర్షన్ అదే UI-ని అదే స్టోరేజ్, అదే లోడింగ్, లోపం స్థితులతో రెండర్ చేస్తుంది. restate ఉదాహరణలు యాప్ ఎంట్రీ పాయింట్‌లో await restateManager.ready ఉందని భావిస్తాయి. సోర్స్‌లు ప్రతి ప్రాజెక్ట్ అధికారిక డాక్యుమెంటేషన్‌తో తనిఖీ చేయబడ్డాయి:

  • Redux Toolkit — Redux Toolkit · Quick Start, React Redux · useSelector, Redux Toolkit · configureStore. ఆడిట్ చేయగల ఒకే action లాగ్, పెద్ద middleware వ్యవస్థ అత్యంత ముఖ్యమైతే దీన్ని ఎంచుకోండి
  • Zustand — Zustand · Introduction, Zustand · persist. అతి చిన్న కోర్‌ను ఇష్టపడి, middleware-ను మీరే జోడించాలనుకుంటే దీన్ని ఎంచుకోండి
  • Jotai — Jotai · atom, Jotai · Storage, Jotai · Provider. మీ స్టేట్ సహజంగా చిన్న ఉత్పన్న విలువల గ్రాఫ్ అయితే దీన్ని ఎంచుకోండి

02 — వేగం

మారినదాన్ని మాత్రమే రెండర్ చేయండి. ఒకసారి రాయండి.

రెండు ప్యానెల్‌లూ మీ బ్రౌజర్‌లో నిజమైన restate ప్యాకేజీని నడుపుతాయి. క్లిక్ చేయండి, టైప్ చేయండి, లెక్కలను గమనించండి.

రెండర్ మ్యాప్

అవే నాలుగు ఫీల్డ్‌లు, రెండు విధాలుగా చదవబడతాయి. ఒక ఫీల్డ్‌ను మార్చి రెండర్‌లను లెక్కించండి.

మొత్తం స్టోర్‌ను చదువుతుంది
  • పేరు
  • థీమ్
  • కౌంటర్
  • డ్రాఫ్ట్
ఒక ఫీల్డ్‌ను ఎంచుకుంటుంది
  • పేరు
  • థీమ్
  • కౌంటర్
  • డ్రాఫ్ట్

కలిపిన రాతలు

autoSave టైపింగ్‌లో విరామం కోసం వేచి ఉండి ఒకసారి రాస్తుంది. వరుస save() కాల్‌లు క్యూలో ఉన్న ఒకే రాతను పంచుకుంటాయి.

persistedRestate('', { key: 'note', autoSave: { delayMs: 400 } });

సంఖ్యలు ఈ పేజీలోని నిజమైన React రెండర్‌ల నుండి, రాతలను లెక్కించే స్టోరేజ్ అడాప్టర్ నుండి వస్తాయి. ఇతర లైబ్రరీలు కూడా విలువలను ఎంచుకోగలవు; ఇక్కడ ఎంచుకోవడం చదివే ఒక విధానం మాత్రమే.

03 — స్థిరత్వం

స్టోరేజ్ విఫలమైనా మీ డేటా సురక్షితంగా ఉంటుంది.

స్టేట్ సేవ్ సమయంలోనే పోతుంది: నెమ్మదైన డిస్క్‌లు, బ్లాక్ అయిన స్టోరేజ్, మూసిన ట్యాబ్‌లు. ఇవి restate 1.0 హామీలు, సలహాలు కావు.

వైఫల్య ప్రయోగశాలను తెరవండి విశ్వసనీయత గైడ్ చదవండి
  1. 01

    సేవ్‌లు వరుసగా జరుగుతాయి

    ప్రతి స్టోర్ స్టోరేజ్ ఆపరేషన్లను ఒక్కొక్కటిగా చేస్తుంది; అందువల్ల నెమ్మదైన సేవ్ ఎప్పుడూ పాత విలువతో కొత్తదాన్ని తిరగరాయదు.

    save() · restore()
  2. 02

    పెండింగ్ సేవ్ తాజా విలువను తీసుకుంటుంది

    మరో సేవ్ క్యూలో ఉండగా save()-ని కాల్ చేస్తే, అదనపు రాతలు పోగుచేయకుండా దానితో కలుస్తుంది.

    save(): Promise<T>
  3. 03

    చదవని రికార్డులు ఎప్పుడూ పొరపాటున మార్చబడవు

    ఒక రికార్డు లోడ్ కాకపోతే, autoSave, బల్క్ సేవ్‌లు దాన్ని తాకకుండా LOAD_FAILED నివేదిస్తాయి. స్పష్టమైన save() మాత్రమే దాన్ని మార్చగలదు.

    LOAD_FAILED
  4. 04

    అన్‌మౌంట్ తర్వాత కూడా సేవ్ పూర్తవుతుంది

    అన్‌మౌంట్‌కు ముందు అభ్యర్థించిన సేవ్‌లు పూర్తవుతాయి. నాశనమైన స్టోర్‌పై తర్వాత వచ్చే రాతలు, అన్‌మౌంట్ తర్వాతి React స్టేట్ లాగే విస్మరించబడతాయి.

    useRestateScope
  5. 05

    స్టోరేజ్ లేదా? యాప్ అయినా ప్రారంభమవుతుంది

    సర్వర్ రెండరింగ్ సమయంలో లేదా స్టోరేజ్ బ్లాక్ అయినప్పుడు, స్టోర్‌లు మెమరీలో పనిచేస్తూనే స్టోరేజ్ అందుబాటులో లేదని నివేదిస్తాయి.

    status().available
  6. 06

    లోపాలు ఏమిటో, ఎక్కడో చెబుతాయి

    ప్రతి restate లోపంలో టైప్ చేసిన కోడ్, దాని రికార్డు key ఉంటాయి; అందువల్ల సరైన సందేశాన్ని చూపించవచ్చు.

    error.code · error.key

మీ యాప్‌తో పాటు పెరుగుతుంది

డిక్లరేషన్‌ను మార్చండి. కాంపోనెంట్లను అలాగే ఉంచండి.

సేవ్, ఆటో-సేవ్, ధ్రువీకరణ ఒకే స్టోర్ యొక్క ఆప్షన్లు. కుడివైపు కాంపోనెంట్ ఎప్పుడూ మారదు.

  1. మెమరీ

    మెమరీలో పంచుకున్న విలువ.

    import { restate } from '@kkwaenggwari/restate';
    
    export const useDraft = restate('');
  2. సేవ్ అయ్యేది

    స్వయంచాలకంగా పునరుద్ధరించబడుతుంది; save() కాల్ చేసినప్పుడు రాయబడుతుంది.

    import { persistedRestate } from '@kkwaenggwari/restate';
    
    export const useDraft = persistedRestate('', { key: 'draft' });
  3. ఆటో-సేవ్

    టైపింగ్‌లో 500 ms విరామం తర్వాత ఒకసారి రాయబడుతుంది.

    import { persistedRestate } from '@kkwaenggwari/restate';
    
    export const useDraft = persistedRestate('', {
      key: 'draft',
      autoSave: { delayMs: 500 },
    });
  4. ధ్రువీకరణతో

    పాత రికార్డులు వాడే ముందు మార్చబడి ధ్రువీకరించబడతాయి.

    import { persistedRestate } from '@kkwaenggwari/restate';
    
    export const useDraft = persistedRestate('', {
      key: 'draft',
      autoSave: { delayMs: 500 },
      version: 2,
      migrate: (value) => String(value ?? ''),
      validate: (value) => typeof value === 'string',
    });

కాంపోనెంట్ — ప్రతి దశలో అదే

function Editor() {
  const text = useDraft();

  return <textarea value={text} onChange={(event) => useDraft.set(event.target.value)} />;
}

React నడిచే ప్రతిచోటా నడుస్తుంది

ప్రతి React వాతావరణానికి ఒకే ప్యాకేజీ.

  • react >=16.8.0

    React

    React 16.8 మరియు కొత్త వెర్షన్‌లతో, బ్రౌజర్‌లో, సర్వర్ రెండరింగ్ సమయంలో నడుస్తుంది.

  • react-native-mmkv >=2.0.0

    React Native

    అవే import-లు. react-native-mmkv ఇన్‌స్టాల్ అయిన తర్వాత సేవ్ MMKV-ని వాడుతుంది.

  • SSR

    సర్వర్ రెండరింగ్

    కాంపోనెంట్ స్టోర్‌లు props నుండి సర్వర్ స్నాప్‌షాట్ తీసుకుని, hydration తర్వాత లోడ్ చేయడం ప్రారంభిస్తాయి.

  • index.d.ts

    TypeScript

    డిక్లరేషన్లు కలిసి వస్తాయి. సెలెక్టర్లు, స్థితి ఫీల్డ్‌లు, లోపం కోడ్‌లు టైప్ చేయబడ్డాయి.

ప్రారంభం

ఒక నిమిషంలో మీ మొదటి పంచుకున్న స్టేట్.

ఇన్‌స్టాల్ చేయండి, ప్రకటించండి, వాడండి. యాప్‌కు అవసరమైనప్పుడు సేవ్‌ను జోడించండి.

  1. 01
    ఇన్‌స్టాలేషన్
    Terminal
    npm install @kkwaenggwari/restate
  2. 02
    ఒక స్టోర్‌ను ప్రకటించండి
    JavaScript / JSX
    export const useCart = restate({ items: 0, total: 0 });
  3. 03
    ఏ కాంపోనెంట్‌లోనైనా చదవండి
    JavaScript / JSX
    const items = useCart((cart) => cart.items);

KKWAENGGWARI

ప్రాజెక్టులు

డాక్యుమెంటేషన్‌లో వెతకండి

అన్ని గైడ్‌ల శీర్షికలు, వివరణలు, విషయంలో వెతకండి.