JSON na URL dotaz

Čo prevod mení

Zapíše plochý objekt JSON ako parametre URL dotazu. Pridá skalárne polia a položky polí pomocou URLSearchParams.

Pracovný príklad

Začnite vstupom zobrazeným na tejto stránke: {"meno":"Ahoj","sprava":["Vitaj","Ahoj"]}. Nástroj vytvorí: meno=Ahoj&sprava=Vitaj&sprava=Ahoj. Najprv skúste príklad a porovnajte obe reprezentácie. Potom ho nahraďte vlastnými údajmi. Výsledok je text, ktorý možno skopírovať do editora, testu či požiadavky až po overení, že cieľ očakáva rovnaký tvar.

Pravidlá a hranice formátu

Dotazovací reťazec nesie pomenované parametre za otáznikom v URL. Nástroj prijíma úvodný otáznik, ale nespracúva celé URL. Riadí sa formulárovými pravidlami URLSearchParams: plus sa mení na medzeru, percentové úniky označujú bajty UTF-8 a opakované kľúče sa pri čítaní uchovajú v poli. Na zápis prijíma plochý objekt JSON s reťazcami, číslami, logickými hodnotami alebo neprázdnymi poľami týchto skalárov. V dotaze je všetko text: číslo zapísané z JSON sa vracia ako reťazec, takže typy sa pri obojsmernom prevode nezachovajú. Null, vnorené objekty a prázdne polia nemajú jednoznačný zápis a odmietnu sa. Zakódovaný ampersand patrí do hodnoty, doslovný oddeľuje parametre. Dekódujte až po rozpoznaní oddeľovačov a nezakódujte výsledok dvakrát.

Kontrola výsledku

Pri kontrole nechajte pôvodný text vedľa prevedeného. Najprv porovnajte malý známy prípad, ideálne s interpunkciou, znakom mimo ASCII, opakovanou hodnotou alebo prázdnym poľom, ktoré je pre vaše dáta dôležité. Čitateľný výstup nedokazuje, že cieľový program prijíma rovnakú schému alebo rovnaké zvyklosti. Pri výmene dát medzi aplikáciami spustite parser cieľovej aplikácie a po importe skontrolujte niekoľko záznamov. Dôležité zdrojové súbory držte vo verziovacom systéme, aby sa zmeny dali vrátiť. Spracovanie prebieha v prehliadači; táto stránka neposiela vložený obsah konverznému serveru. Pamäť prehliadača a schránka však na zdieľanom zariadení stále vyžadujú bežnú opatrnosť.

Zdroj a výsledok majú odlišnú úlohu, aj keď vyzerajú podobne. Vyššie uvedený postup opisuje podporovanú podmnožinu, nie všetky rozšírenia formátu. Pri prísnom cieľovom systéme najprv vyskúšajte malý známy prípad a až potom meňte mnoho záznamov. Ak overenie zlyhá, vráťte sa k zdroju a prvej nahlásenej chybe; oprava iba výstupu môže zakryť príčinu.

Vyskúšajte parametre s hodnotou obsahujúcou medzeru, ampersand a znak mimo ASCII. Vytvorený reťazec znova načítajte a overte, že opakované kľúče zostali poľami. Porovnávajte textové hodnoty, nie číselné či logické typy JSON, ktoré dotaz nedokáže zachovať. Ak potrebujete celé URL, pripojte výsledný dotaz za jeho cestu namiesto vloženia celého URL do vstupu.