8. Gde aplikacija čuva stanje
Poglavlje 8

Gde aplikacija čuva stanje

Aplikacija ima četiri mesta za podatke, i svako je za nešto drugo: vrednosti dele svi članovi, lična memorija pripada gledaocu na svakom uređaju, localStorage samo ovom pregledaču, a adresa strane onome ko dobije link. Izbor mesta je prva odluka pri dizajnu aplikacije.

8.1. Četiri mesta

Četiri mesta za stanje: vrednosti vide svi članovi grupe; lična memorija samo gledalac, na svakom uređaju; localStorage samo ovaj pregledač; adresa strane onaj ko dobije link. vrednosti insertValue vide ih svi članovi grupe trajno, na serveru uglavnom se dodaju lična memorija setPersonal samo gledalac, na svakom uređaju na serveru 100 ključeva × 16 KB localStorage setItem samo ovaj pregledač kopija po mestu do 256 KB adresa strane linkGroup onaj ko dobije link ?at=<id> niko je ne proverava
Ko vidi podatak i koliko traje: od deljenog i trajnog (levo) do ličnog i prolaznog (desno).
MestoKo vidiZa štaPozivi
vrednosti i kolekciječlanovi grupe, po pravilima kolekcijesve što aplikacija deli: unosi, glasovi, poteziinsertValue, listValues
lična memorijasamo gledalac, na svakom uređajudokle je stigao, podešavanja, beleške za sebesetPersonal, getPersonal
localStoragesamo ovaj pregledačizgled i udobnost: otvoren panel, poslednji filterlocalStorage.setItem
adresa stranesvako ko otvori linkna kojoj je stavci aplikacija otvorenalinkGroup, getLinkedGroup

Opis aplikacije nije peto mesto: updateDescription menja kod aplikacije i ponovo je pokreće (poglavlje 4).

8.2. Vrednosti: zajedničko stanje

Sve što treba da vide drugi ide u vrednosti: običnu listu vrednosti aplikacije (poglavlje 5) ili kolekciju sa pravilima (poglavlje 9). Podešavanja koja važe za sve gledaoce (naslov, rok, izgled) čuva konfiguracija aplikacije (getConfig, saveConfig): njen data drži ono što aplikacija hoće, a menjaju je urednici.

8.3. Lična memorija

Lična memorija je ono što aplikacija čuva samo za gledaoca, isto na svakom uređaju: na primer dokle je stiglo čitanje. Ne čita je niko drugi, ni urednici aplikacije, a gledalac je vidi i briše u podešavanjima potok-a.

window.potok.listPersonal()
{ok: true, items: [{key, value, updated_at}]}: svi ključevi ove aplikacije za gledaoca.
window.potok.getPersonal(key)
{ok: true, value}; value je null za ključ koji ne postoji.
window.potok.setPersonal(key, value)
Čuva bilo šta što JSON drži; {ok: true}. Troši limit upisa.
window.potok.deletePersonal(key)
Zaboravlja ključ; ključ koji ne postoji nije greška. Troši limit upisa.
GranicaGreška
ključ ima od 1 do 64 slova, cifara i znakova _ . : -invalid_key
vrednost do 16 KB kao JSONtoo_big
najviše 100 ključeva po osobi, po aplikacijitoo_many_keys
type Progress = { chapter: number; done: number[] };

async function loadProgress(): Promise<Progress> {
  const reply = await window.potok.getPersonal<Progress>('progress');
  if (!reply.ok || !reply.value) return { chapter: 1, done: [] };
  return reply.value;
}

async function finishChapter(progress: Progress, chapter: number) {
  const next: Progress = { chapter: chapter + 1, done: [...progress.done, chapter] };
  const reply = await window.potok.setPersonal('progress', next);
  if (!reply.ok) console.error(reply.error);
  return next;
}

void loadProgress().then((progress) => finishChapter(progress, progress.chapter));
Dev mock

Lična memorija stoji pod ključem potok-dev:personal, posebno za svakog gledaoca iz ?viewer= i svaku aplikaciju, sa istim ograničenjima kao u potok-u.

8.4. localStorage i sessionStorage

localStorage radi, iako okvir nema poreklo: stranica čuva posebnu kopiju za svaku aplikaciju, najviše 256 KB, i vraća je pri sledećem otvaranju. sessionStorage živi samo u memoriji.

type Ui = { panel: 'list' | 'map' };

function readUi(): Ui {
  try {
    const parsed: unknown = JSON.parse(localStorage.getItem('ui') ?? 'null');
    if (parsed && typeof parsed === 'object' && (parsed as Ui).panel === 'map') return { panel: 'map' };
  } catch {
    // no storage, or someone else's copy: fall back to the default
  }
  return { panel: 'list' };
}

function writeUi(ui: Ui) {
  try {
    localStorage.setItem('ui', JSON.stringify(ui));
  } catch {
    // nothing to keep it in
  }
}

writeUi(readUi());
Dev mock

U dev-u aplikacija i dev mock dele isti localStorage origina localhost:5173. Ključevi mock-a počinju sa potok-dev:; ne koristi taj prefiks za svoje (poglavlje 13).

8.5. Adresa strane

Aplikacija koja prikazuje mnogo stavki (objave, mesta, zapise) često želi da link vodi baš na jednu. Okvir ne može da menja adresu strane, pa za to postoje dva poziva:

Upisuje grupu u adresu strane (?at=<id>), bez novog koraka u istoriji, pa ta adresa otvara aplikaciju baš tu. Šalji grupu koja je na ekranu.
window.potok.getLinkedGroup()
{ok: true, group_id}: grupa iz adrese ili null. Niko je ne proverava: proveru radi listSubgroups sa aroundId, po onome što gledalac vidi (poglavlje 11).

Adresa nosi samo id grupe, pa radi za aplikacije čije su stavke podgrupe. Stavku iz vrednosti aplikacija pamti u ličnoj memoriji ili localStorage-u.