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
| Mesto | Ko vidi | Za šta | Pozivi |
|---|---|---|---|
| vrednosti i kolekcije | članovi grupe, po pravilima kolekcije | sve što aplikacija deli: unosi, glasovi, potezi | insertValue, listValues |
| lična memorija | samo gledalac, na svakom uređaju | dokle je stigao, podešavanja, beleške za sebe | setPersonal, getPersonal |
localStorage | samo ovaj pregledač | izgled i udobnost: otvoren panel, poslednji filter | localStorage.setItem |
| adresa strane | svako ko otvori link | na kojoj je stavci aplikacija otvorena | linkGroup, 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};valuejenullza 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.
| Granica | Greška |
|---|---|
ključ ima od 1 do 64 slova, cifara i znakova _ . : - | invalid_key |
| vrednost do 16 KB kao JSON | too_big |
| najviše 100 ključeva po osobi, po aplikaciji | too_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));
- Gostu lična memorija ostaje u pregledaču, sa istim ograničenjima.
- Ne čitaju je ni kolekcije ni procesi aplikacije. Brisanje aplikacije, njene grupe ili naloga briše i nju.
- Šta god drugi treba da vide ne ide ovde: lična memorija se ne deli i ne može se sabrati preko gledalaca.
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.
- Kopija je u ovom pregledaču. Na telefonu i računaru istog gledaoca su dve različite kopije; za ono što treba da prati gledaoca koristi ličnu memoriju.
- Kopija pripada mestu, ne aplikaciji: posle „Postavi kao podrazumevani“ svaka aplikacija nađe kopiju one druge (poglavlje 7). Proveri oblik onoga što pročitaš.
- Čitanje i upis obavij u
try/catch: u sajtu u okviru aplikacije (poglavlje 1)localStorageuopšte ne postoji.
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());
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:
window.potok.linkGroup(id)- 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 ilinull. Niko je ne proverava: proveru radilistSubgroupssaaroundId, 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.