URL dotaz na JSON

Co převod mění

Načte parametry URL dotazu jako objekt JSON a zachová opakované klíče. Dekóduje formulářové parametry a opakované názvy shromáždí do polí.

Pracovní příklad

Začněte vstupem zobrazeným na této stránce: jmeno=Ahoj&zprava=V%C3%ADtej&zprava=Ahoj. Nástroj vytvoří: { "jmeno": "Ahoj", "zprava": [ "Vítej", "Ahoj" ] }. Nejprve zkuste příklad a porovnejte obě reprezentace. Potom jej nahraďte vlastními údaji. Výsledek je text, který lze zkopírovat do editoru, testu či požadavku až po ověření, že cíl očekává stejný tvar.

Pravidla a hranice formátu

Dotazovací řetězec nese pojmenované parametry za otazníkem v URL. Nástroj přijímá úvodní otazník, ale nezpracovává celé URL. Řídí se formulářovými pravidly URLSearchParams: plus se mění na mezeru, procentové úniky označují bajty UTF-8 a opakované klíče se při čtení uchovají v poli. Pro zápis přijímá plochý objekt JSON s řetězci, čísly, logickými hodnotami nebo neprázdnými poli těchto skalárů. V dotazu je vše text: číslo zapsané z JSON se vrací jako řetězec, takže typy se při obousměrném převodu nezachovají. Null, vnořené objekty a prázdná pole nemají jednoznačný zápis a odmítnou se. Zakódovaný ampersand patří do hodnoty, doslovný odděluje parametry. Dekódujte až po rozpoznání oddělovačů a nezakódujte výsledek dvakrát.

Kontrola výsledku

Při kontrole nechte původní text vedle převedeného. Nejprve porovnejte malý známý případ, ideálně s interpunkcí, znakem mimo ASCII, opakovanou hodnotou nebo prázdným polem důležitým pro vaše data. Čitelný výstup nedokazuje, že cílový program přijímá stejné schéma nebo stejné zvyklosti. Při výměně dat mezi aplikacemi spusťte parser cílové aplikace a po importu zkontrolujte několik záznamů. Důležité zdrojové soubory držte ve verzovacím systému, aby se změny daly vrátit. Zpracování probíhá v prohlížeči; tato stránka neposílá vložený obsah konverznímu serveru. Paměť prohlížeče a schránka však na sdíleném zařízení stále vyžadují běžnou opatrnost.

Zdroj a výsledek mají odlišnou úlohu, i když vypadají podobně. Výše uvedený postup popisuje podporovanou podmnožinu, ne všechna rozšíření formátu. U přísného cílového systému nejprve vyzkoušejte malý známý případ a teprve potom měňte mnoho záznamů. Pokud ověření selže, vraťte se ke zdroji a první nahlášené chybě; oprava jen výstupu může zakrýt příčinu.

Vyzkoušejte parametry s hodnotou obsahující mezeru, ampersand a znak mimo ASCII. Vytvořený řetězec znovu načtěte a ověřte, že opakované klíče zůstaly poli. Porovnávejte textové hodnoty, ne číselné či logické typy JSON, které dotaz nedokáže zachovat. Pokud potřebujete celé URL, připojte výsledný dotaz za jeho cestu místo vložení celé URL do vstupu.