Playground

Αλλάξτε τις εισόδους. Δείτε πώς αντιδρά το restate.

Επτά πειράματα τρέχουν το πραγματικό πακέτο. Ο ελεγκτής στα αριστερά ανήκει σε αυτόν τον ιστότοπο· το παράδειγμα στα δεξιά λαμβάνει μόνο props, οπότε ο κώδικάς του είναι ακριβώς αυτός που θα γράφατε εσείς.

Ελεγκτής — μόνο για τον ιστότοποprops — η γέφυραΠαράδειγμα — ο κώδικας που αντιγράφετε

Δύο οθόνες, ένα store

Πολλά components χρειάζονται την ίδια τιμή. Δηλώστε την μία φορά και διαβάστε την οπουδήποτε.

Τι να προσέξετε

Πατήστε το κουμπί βήματος: όλοι οι αναγνώστες δείχνουν τον νέο αριθμό την ίδια στιγμή.
Αλλάξτε τον αριθμό των αναγνωστών: ένας νέος αναγνώστης ξεκινά από την τρέχουσα τιμή.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Αναγνώστεςreaders
Βήμαstep

<Example
  readers={3}
  step={1}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { restate } from '@kkwaenggwari/restate';
import './styles.css';

const useCount = restate(0);

function Reader({ name }) {
  const count = useCount();

  return (
    <section className="card">
      <span>{name}</span>
      <output>{count}</output>
    </section>
  );
}

export default function Example({ readers = 3, step = 1 }) {
  return (
    <main>
      <div className="grid">
        {Array.from({ length: readers }, (_, index) => (
          <Reader key={index} name={`Οθόνη ${index + 1}`} />
        ))}
      </div>
      <div className="actions">
        <button onClick={() => useCount.set((count) => count + step)}>+{step}</button>
        <button onClick={() => useCount.reset()}>Επαναφορά</button>
      </div>
    </main>
  );
}

Πρώτα βήματα

Αποδώστε μόνο ό,τι άλλαξε

Ένα μεγάλο store δεν πρέπει να αποδίδει ξανά κάθε component σε κάθε αλλαγή.

Τι να προσέξετε

Επεξεργαστείτε την κάρτα: αποδίδεται μόνο η κάρτα ολόκληρου του store.
Προσθέστε προϊόν: αποδίδονται τα προϊόντα και η σύνοψη· η κάρτα κουπονιού μένει ακίνητη.
Απενεργοποιήστε το shallow: η σύνοψη αποδίδεται σε κάθε αλλαγή, επειδή ο selector της επιστρέφει νέο αντικείμενο κάθε φορά.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Σύγκριση σύνοψης με shallowshallowSummary

<Example
  shallowSummary={true}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { memo, useRef } from 'react';
import { restate, shallow } from '@kkwaenggwari/restate';
import './styles.css';

const useCart = restate({ items: ['Book'], coupon: '', note: '' });

function Card({ title, value }) {
  const renders = useRef(0);
  renders.current += 1;

  return (
    <section className="card">
      <span>{title}</span>
      <output>{value}</output>
      <small>{`Αποδόσεις: ${renders.current}`}</small>
    </section>
  );
}

const ItemCount = memo(function ItemCount() {
  const count = useCart((cart) => cart.items.length);
  return <Card title="Προϊόντα" value={count} />;
});

const Coupon = memo(function Coupon() {
  const coupon = useCart((cart) => cart.coupon);
  return <Card title="Κουπόνι" value={coupon || 'κανένα'} />;
});

const Summary = memo(function Summary({ compare }) {
  const summary = useCart((cart) => ({ count: cart.items.length, coupon: cart.coupon }), compare);
  return <Card title="Σύνοψη" value={`${summary.count} · ${summary.coupon || '-'}`} />;
});

const Whole = memo(function Whole() {
  const cart = useCart();
  return <Card title="Ολόκληρο το store" value={cart.note.length} />;
});

export default function Example({ shallowSummary = true }) {
  return (
    <main>
      <div className="grid">
        <ItemCount />
        <Coupon />
        <Summary compare={shallowSummary ? shallow : undefined} />
        <Whole />
      </div>
      <div className="actions">
        <button onClick={() => useCart.set((cart) => ({ ...cart, items: [...cart.items, 'Pen'] }))}>
          Προσθήκη προϊόντος
        </button>
        <button
          onClick={() => useCart.set((cart) => ({ ...cart, coupon: cart.coupon ? '' : 'SPRING' }))}
        >
          Εναλλαγή κουπονιού
        </button>
        <button onClick={() => useCart.set((cart) => ({ ...cart, note: cart.note + '!' }))}>
          Επεξεργασία κάρτας
        </button>
      </div>
    </main>
  );
}

Γίνετε συνδρομητής μόνο σε ό,τι χρειάζεστε

Πολλές αλλαγές, μία ειδοποίηση

Η ενημέρωση δύο stores τη μία μετά την άλλη μπορεί να αφήσει έναν συνδρομητή να δει μισοτελειωμένη κατάσταση.

Τι να προσέξετε

Άδειασμα ξεχωριστά: ο συνδρομητής βλέπει 0 προϊόντα μαζί με το παλιό κουπόνι.
Άδειασμα με batch: ο συνδρομητής εκτελείται μία φορά, αφού αλλάξουν και τα δύο stores.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Προϊόνταquantity
Κουπόνιcoupon

<Example
  quantity={3}
  coupon="SPRING"
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { useEffect, useState } from 'react';
import { batch, restate } from '@kkwaenggwari/restate';
import './styles.css';

const useItems = restate([]);
const useCoupon = restate('');

export default function Example({ quantity = 3, coupon = 'SPRING' }) {
  const items = useItems();
  const code = useCoupon();
  const [notices, setNotices] = useState([]);

  useEffect(() => {
    useItems.set(Array.from({ length: quantity }, (_, index) => `#${index + 1}`));
    useCoupon.set(coupon);
    setNotices([]);
  }, [quantity, coupon]);

  useEffect(
    () =>
      useItems.subscribe((next) => {
        const notice = `Ειδοποιήθηκε: ${next.length} προϊόντα · κουπόνι ${useCoupon.get() || '-'}`;
        setNotices((list) => [...list, notice]);
      }),
    [],
  );

  const clear = () => {
    useItems.set([]);
    useCoupon.set('');
  };

  return (
    <main>
      <div className="grid">
        <section className="card">
          <span>Προϊόντα</span>
          <output>{items.length}</output>
        </section>
        <section className="card">
          <span>Κουπόνι</span>
          <output>{code || '-'}</output>
        </section>
      </div>
      <div className="actions">
        <button onClick={clear}>Άδειασμα ξεχωριστά</button>
        <button onClick={() => batch(clear)}>Άδειασμα με batch</button>
      </div>
      <h2>Τι είδε ο συνδρομητής</h2>
      <ol className="log">
        {notices.length ? (
          notices.map((notice, index) => <li key={index}>{notice}</li>)
        ) : (
          <li>Καμία ειδοποίηση ακόμη.</li>
        )}
      </ol>
    </main>
  );
}

Γίνετε συνδρομητής μόνο σε ό,τι χρειάζεστε

Αποθηκεύστε όταν αποφασίσετε

Η επεξεργασία αλλάζει τη μνήμη. Η αποθήκευση είναι ρητή ενέργεια και η κατάσταση δείχνει τι συμβαίνει.

Τι να προσέξετε

Πληκτρολογήστε: το dirty ενεργοποιείται και ακόμη δεν γράφεται τίποτα.
Αυξήστε την καθυστέρηση και αποθηκεύστε: το operation δείχνει save όσο διαρκεί η εγγραφή.
Επανάληψη: το αποθηκευμένο πρόχειρο ανακτάται από το IndexedDB.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Καθυστέρηση αποθήκευσηςlatency

<Example
  latency={600}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { useEffect } from 'react';
import { persistedRestate } from '@kkwaenggwari/restate';
import { settings, slowStorage } from './storage.js';
import './styles.css';

const useDraft = persistedRestate('', { key: 'playground-draft', storage: slowStorage });

export default function Example({ latency = 600 }) {
  useEffect(() => {
    settings.latency = latency;
  }, [latency]);

  const text = useDraft();
  const { dirty, operation, pending, lastSavedAt } = useDraft.useStatus();
  // A failed save keeps dirty and records status.error.
  const save = () => useDraft.save().catch(() => {});
  const revert = () => useDraft.restore().catch(() => {});

  return (
    <main>
      <label>
        Πρόχειρο
        <textarea value={text} onChange={(event) => useDraft.set(event.target.value)} />
      </label>
      <div className="actions">
        <button disabled={!dirty} onClick={save}>
          Αποθήκευση
        </button>
        <button disabled={!dirty} onClick={revert}>
          Απόρριψη αλλαγών
        </button>
      </div>
      <dl className="status">
        <dt>dirty</dt>
        <dd className={dirty ? 'warn' : 'ok'}>
          {dirty ? 'μη αποθηκευμένες αλλαγές' : 'αποθηκεύτηκε'}
        </dd>
        <dt>operation</dt>
        <dd>{operation ?? 'καμία'}</dd>
        <dt>pending</dt>
        <dd>{pending}</dd>
        <dt>lastSavedAt</dt>
        <dd>{lastSavedAt ? new Date(lastSavedAt).toLocaleTimeString() : 'όχι ακόμη'}</dd>
      </dl>
    </main>
  );
}

storage.js

import { createIndexedDBStorage } from '@kkwaenggwari/restate';

// IndexedDB with an adjustable delay, to watch operations in progress.
const indexedDB = createIndexedDBStorage();
export const settings = { latency: 0 };
const wait = () => new Promise((resolve) => setTimeout(resolve, settings.latency));

export const slowStorage = {
  async getItem(key) {
    await wait();
    return indexedDB.getItem(key);
  },
  async setItem(key, value) {
    await wait();
    return indexedDB.setItem(key, value);
  },
  async removeItem(key) {
    await wait();
    return indexedDB.removeItem(key);
  },
};

Αποθηκεύστε όταν αποφασίσετε

Πληκτρολογήστε γρήγορα, γράψτε μία φορά

Η αποθήκευση σε κάθε πάτημα πλήκτρου πλημμυρίζει την αποθήκευση. Το autoSave περιμένει μια παύση.

Τι να προσέξετε

Πληκτρολογήστε μια πρόταση: οι αλλαγές ανεβαίνουν γρήγορα, ενώ οι εγγραφές αυξάνονται κατά μία μετά από κάθε παύση.
Επιλέξτε «Σε κάθε αλλαγή»: κάθε αλλαγή γράφεται, και η επιστροφή στην αποθηκευμένη τιμή δεν γράφει τίποτα.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Αναμονή autoSavedelayMs

<Example
  delayMs={800}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { useState } from 'react';
import { persistedRestate, useRestateScope } from '@kkwaenggwari/restate';
import { countingStorage, useWrites } from './storage.js';
import './styles.css';

function Note({ delayMs }) {
  const useNote = useRestateScope((scope) =>
    persistedRestate('', {
      scope,
      key: 'note',
      storage: countingStorage,
      autoSave: delayMs ? { delayMs } : true,
    }),
  );
  const note = useNote();
  const dirty = useNote.useStatus((status) => status.dirty);
  const writes = useWrites();
  const [edits, setEdits] = useState(0);

  return (
    <>
      <label>
        Σημείωση
        <textarea
          value={note}
          placeholder="Πληκτρολογήστε γρήγορα μια πρόταση…"
          onChange={(event) => {
            useNote.set(event.target.value);
            setEdits((count) => count + 1);
          }}
        />
      </label>
      <div className="grid">
        <section className="card">
          <span>Αλλαγές</span>
          <output>{edits}</output>
        </section>
        <section className="card accent">
          <span>Εγγραφές στην αποθήκευση</span>
          <output>{writes}</output>
        </section>
      </div>
      <p className={dirty ? 'badge warn' : 'badge ok'}>
        {dirty ? 'αναμονή για παύση' : 'αποθηκεύτηκε'}
      </p>
    </>
  );
}

export default function Example({ delayMs = 800 }) {
  // autoSave is part of the declaration: a new delay starts a new scope.
  return (
    <main>
      <Note key={delayMs} delayMs={delayMs} />
    </main>
  );
}

storage.js

import { restate } from '@kkwaenggwari/restate';

// An in-memory storage adapter that counts real writes.
const records = new Map();
export const useWrites = restate(0);

export const countingStorage = {
  getItem: (key) => records.get(key) ?? null,
  setItem: (key, value) => {
    records.set(key, value);
    useWrites.set((count) => count + 1);
  },
  removeItem: (key) => {
    records.delete(key);
  },
};

Αποθηκεύστε όταν αποφασίσετε

Εργαστήριο αστοχιών

Κάντε την αποθήκευση αργή, χαλασμένη ή μη διαθέσιμη και δείτε πώς το restate κρατά τα δεδομένα σας και αναφέρει το πρόβλημα.

Τι να προσέξετε

Αυξήστε την καθυστέρηση και αποθηκεύστε τρεις φορές: τα αιτήματα μοιράζονται μία εγγραφή, οπότε το pending μένει 1 και και τα τρία αποτελέσματα φτάνουν μαζί.
Ενεργοποιήστε τις αποτυχημένες εγγραφές και αποθηκεύστε: το dirty μένει true και το error δείχνει την αιτία.
Κάντε την αποθήκευση μη διαθέσιμη: η αποθήκευση απορρίπτεται με STORAGE_UNAVAILABLE, αλλά η επεξεργασία συνεχίζεται.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Καθυστέρησηlatency
Αποτυχημένες εγγραφέςfailWrites
Αποθήκευση μη διαθέσιμηunavailable

<Example
  latency={700}
  failWrites={false}
  unavailable={false}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { useEffect, useState } from 'react';
import { persistedRestate } from '@kkwaenggwari/restate';
import { flakyStorage, settings } from './storage.js';
import './styles.css';

const useNote = persistedRestate('', { key: 'lab-note', storage: flakyStorage });

export default function Example({ latency = 700, failWrites = false, unavailable = false }) {
  useEffect(() => {
    Object.assign(settings, { latency, failWrites, unavailable });
  }, [latency, failWrites, unavailable]);

  const note = useNote();
  const { dirty, operation, pending, error } = useNote.useStatus();
  const [results, setResults] = useState([]);

  const save = () =>
    useNote.save().then(
      (value) => setResults((list) => [`Αποθηκεύτηκε: ${JSON.stringify(value)}`, ...list]),
      (reason) => setResults((list) => [`Απέτυχε: ${reason.code ?? reason.message}`, ...list]),
    );

  return (
    <main>
      <label>
        Σημείωση
        <input value={note} onChange={(event) => useNote.set(event.target.value)} />
      </label>
      <div className="actions">
        <button onClick={save}>Αποθήκευση</button>
        <button
          onClick={() => {
            save();
            save();
            save();
          }}
        >
          Αποθήκευση τρεις φορές
        </button>
      </div>
      <dl className="status">
        <dt>dirty</dt>
        <dd className={dirty ? 'warn' : 'ok'}>{String(dirty)}</dd>
        <dt>operation</dt>
        <dd>{operation ?? '-'}</dd>
        <dt>pending</dt>
        <dd>{pending}</dd>
        <dt>error</dt>
        <dd className={error ? 'bad' : ''}>{error ? (error.code ?? error.message) : '-'}</dd>
      </dl>
      <h2>Αποτελέσματα</h2>
      <ol className="log">
        {results.length ? (
          results.map((result, index) => <li key={results.length - index}>{result}</li>)
        ) : (
          <li>-</li>
        )}
      </ol>
    </main>
  );
}

storage.js

// A storage adapter whose speed and failures you can change.
const records = new Map();
export const settings = { latency: 0, failWrites: false, unavailable: false };
const wait = () => new Promise((resolve) => setTimeout(resolve, settings.latency));

export const flakyStorage = {
  isAvailable: () => !settings.unavailable,
  async getItem(key) {
    await wait();
    return records.get(key) ?? null;
  },
  async setItem(key, value) {
    await wait();
    if (settings.failWrites) throw new Error('Ο δίσκος είναι γεμάτος');
    records.set(key, value);
  },
  async removeItem(key) {
    await wait();
    records.delete(key);
  },
};

Αξιόπιστο από τον σχεδιασμό

Κατάσταση ανά έγγραφο

Κάθε ανοιχτό έγγραφο χρειάζεται τη δική του κατάσταση, που απελευθερώνεται όταν κλείνει το έγγραφο.

Τι να προσέξετε

Πληκτρολογήστε στο έγγραφο A και μετά στο B: το καθένα κρατά το δικό του κείμενο.
Κλείστε το έγγραφο A και ανοίξτε το ξανά: ξεκινά κενό, επειδή το scope του καταστράφηκε.

ΕλεγκτήςΔεν είναι μέρος του κώδικα του παραδείγματος. Οι τιμές φτάνουν στο παράδειγμα ως props.

Έγγραφαdocuments
Το έγγραφο A είναι ανοιχτόfirstOpen

<Example
  documents={2}
  firstOpen={true}
/>

Προετοιμασία παραδείγματος…

Τα ζωντανά παραδείγματα χρειάζονται JavaScript. Μπορείτε να διαβάσετε τον κώδικα παρακάτω όπως είναι.

App.jsx

import { restate, useRestateScope } from '@kkwaenggwari/restate';
import './styles.css';

function Document({ name }) {
  const useText = useRestateScope((scope) => restate('', { scope }));
  const text = useText();

  return (
    <section className="card">
      <span>{name}</span>
      <input
        value={text}
        placeholder="Γράφτηκε μόνο εδώ"
        onChange={(event) => useText.set(event.target.value)}
      />
      <small>{`${text.length} χαρακτήρες`}</small>
    </section>
  );
}

export default function Example({ documents = 2, firstOpen = true }) {
  const names = ['A', 'B', 'C'].slice(0, documents);

  return (
    <main>
      <div className="grid">
        {names.map((name, index) =>
          index === 0 && !firstOpen ? null : <Document key={name} name={`Έγγραφο ${name}`} />,
        )}
      </div>
    </main>
  );
}

Κατάσταση που ανήκει σε component