JavaScript a TypeScript

Obchodník v prehliadači upraví množstvo na cenovej ponuke a potrebuje hneď vidieť nový súčet aj to, či zľava vyžaduje schválenie. V JavaScripte a TypeScripte pripravujeme takéto pracovné rozhrania a prepájame ich so serverom, ktorý skontroluje a uloží výsledok.

Evidencia dopytov, D-027. Prijaté fotografie: 3. Podklady na jednej karte.
Modelová ukážka rozhrania

Čo s nimi staviame

  • Formuláre s okamžitým prepočtom ponuky a potvrdením uloženia v Reacte
  • Webové aplikácie a portály v Next.js
  • Rýchle firemné weby v Astro
  • Mobilné aplikácie v React Native

Ktorý rámec na čo

NástrojKedy ho používame
ReactInteraktívne rozhrania firemných systémov s veľa formulármi a zoznamami
Next.jsWebové aplikácie a portály, kde sa stretáva rozhranie a serverová časť
AstroRýchle obsahové weby, ktoré musia byť dobre čitateľné pre vyhľadávače
React NativeMobilné aplikácie, ktoré zdieľajú časť logiky s webom

Prečo píšeme v TypeScripte

  • TypeScript upozorní napríklad na chýbajúce povinné pole v kóde. Údaje prichádzajúce z formulára alebo cudzieho systému sa overujú aj za behu
  • Kód je čitateľnejší pre ďalšieho vývojára
  • Bezpečnejšie úpravy vo väčších systémoch
  • Lepšie nástroje pri vyhľadávaní a premenovaní v kóde

Rozhodnutia pri návrhu

JavaScript obsluhuje udalosti a zmeny rozhrania. TypeScript pridáva typovú kontrolu pri vývoji, ale údaje z externého API sa musia overiť aj počas behu.

Pri rýchlej zmene filtra môže staršia odpoveď doraziť ako posledná. Rozhranie ju potrebuje odlíšiť od aktuálnej požiadavky.

Príklad z pracovného postupu

Používateľ napíše do vyhľadávania „Br“ a potom „Bratislava“. Prvá odpoveď dorazí neskôr. Ak sa zobrazí bez kontroly aktuálnej požiadavky, tabuľka bude hlásiť aktívny plný filter, ale obsahovať starší širší výsledok.

Ako výsledok overiť

Skúška naschvál otočí poradie odoziev a overí zobrazené položky, aktívny filter i stav po chybe spojenia.

Rozpracované hodnoty a odozva rozhrania

Pri úprave evidencie rozlišujeme hodnotu na serveri, lokálny koncept a požiadavku, ktorá už bola odoslaná. Ak dôjde k chybe, formulár má zachovať opravené údaje a konkrétne uviesť, ktorý krok sa nepodaril. Po obnovení stránky má používateľ vidieť skutočne potvrdený výsledok.

Užitočný skúšobný scenár kombinuje pomalé pripojenie, súbežnú zmenu iným používateľom a obsluhu klávesnicou. Zmenené písmo, dlhý názov alebo menšia obrazovka nesmú zakryť význam potvrdenia ani chybovej správy.

Pôvodný odborný zdroj – JavaScript a TypeScript

Typ v zdrojovom kóde a údaje, ktoré naozaj prišli

Formulár môže pracovať s číselným množstvom, no externé rozhranie môže poslať text, prázdnu hodnotu alebo množstvo s inou jednotkou. TypeScript pomáha kontrolovať vzťahy v kóde. Na hranici aplikácie treba osobitne overiť skutočný tvar dát, zachytiť neplatnú kombináciu a priradiť jej užitočný dôvod odmietnutia.

Pri objednávkovom formulári preverte hodnoty nula, prázdny vstup a jednotku „balenie“ pri výrobku predávanom po kusoch. Rovnaké rozhodnutie musí platiť na serveri aj pri obídení bežnej formulárovej obrazovky. Používateľ má po chybe dostať možnosť opraviť konkrétny riadok bez straty ostatných.

Aký význam má chýbajúca hodnota po úprave formulára

Pri čiastočnej zmene zákazky môže chýbajúce pole znamenať „ponechaj pôvodnú hodnotu“, zatiaľ čo prázdna hodnota môže znamenať „odober rezervovaný termín“. Dohodnite tento rozdiel v klientovi aj na rozhraní a otestujte ho na existujúcom zázname. Pri novšej verzii klienta nezabudnite na aplikácie, ktoré ešte odosielajú pôvodný formát. Zobrazená hodnota po opätovnom otvorení dokladu má zodpovedať tej istej interpretácii ako rozhodnutie servera pri uložení.

Obchodný deň sa nemá po prenose posunúť o deň dozadu

Termín dodania „12. jún“ môže v aplikácii znamenať miestny kalendárny deň, zatiaľ čo čas podpisu je presný okamih. Ak oboje prevádzame rovnakým spôsobom na časové známky, pri zobrazení v inom pásme môže zákazník vidieť odlišný dátum dodania.

V dátovom rozhraní tieto významy pomenujeme samostatne. Skúšobná objednávka sa otvorí na zariadeniach s dvoma rôznymi pásmami a pri prechode cez polnoc. Termín dodania zostane rovnakým dňom, čas podpisu sa zobrazí podľa zvoleného spôsobu interpretácie.

Otázky z praxe

Prečo sa po zmene filtra niekedy objavia staršie výsledky?

Zoznam používateľ najprv obmedzí na január a hneď nato na február. Pomalšia januárová odpoveď môže prísť neskôr. Každé spracovanie zviažeme s aktuálnym výberom a pri dobehnutí overíme jeho platnosť, vrátane toho, ktorý dotaz smie skryť indikátor načítania.

Zaručí typ odpovede z API správne údaje počas behu?

Typy pomáhajú preveriť prácu s dátami v zdrojovom kóde. Dáta prijaté cez sieť však môžu mať inú štruktúru, zvlášť počas súbehu dvoch verzií služby. Pri vstupe preto overíme povinné polia, prípustné hodnoty a prepočet meny skôr, ako sa suma objaví v potvrdení objednávky.

Čo má urobiť formulár pri opakovanom stlačení Uložiť?

V rozhraní označíme prebiehajúce spracovanie a potlačíme náhodný druhý klik. Keď odpoveď zanikne na sieti, používateľ potrebuje zistiť výsledok prvého pokusu. Na strane servera preto spájame rovnaký zámer o uloženie s jedným výsledkom a odlišujeme ho od zámernej ďalšej úpravy.

Potrebujete poradiť?

Opíšte nám, čo potrebujete vyriešiť. Odpovedáme e-mailom.

O čo máte záujem?

Martin Michalka vám pošle návrh e-mailom. Opíšte jednu úlohu, ktorú vo firme robíte opakovane.

Ako vás máme kontaktovať?