JSON-snyrtir

Skilningur á JSON og mikilvægi villuprófunar

JSON (JavaScript Object Notation) er eitt útbreiddasta sniðið til að flytja og geyma gögn í nútíma hugbúnaðargerð og samskiptum milli vefþjónustna (API). Þótt sniðið sé hannað til að vera auðlesanlegt fyrir bæði menn og tölvur, geta smávægilegar innsláttarvillur gert gögnin ógild. JSON-snyrtir er tól sem hjálpar notendum að snyrta, villuprófa og smækka JSON-gögn á fljótlegan og öruggan hátt.

Þegar unnið er með JSON er nákvæmni lykilatriði. Ólíkt sumum öðrum sniðum leyfir staðallinn engar málfræðilegar tilslakanir. Ef einhver villa er til staðar mun tólið sýna stöðuna „Ógilt JSON“. Til að auðvelda lagfæringar sýnir kerfið nákvæma staðsetningu villunnar með sniðinu „lína {line}, dálkur {col}“ ásamt hnappi til að „Fara á villuna“.

Algengar villur í JSON og hvernig á að leysa þær

Tólið greinir sjálfkrafa margs konar málskipunarvillur sem oft koma upp við handvirka ritun eða flutning gagna. Meðal þeirra villna sem kerfið finnur og tilgreinir eru:

• „Kommu vantar á milli staka“: Kemur upp ef gleymist að setja kommu á milli gilda í fylki eða lykla í hlut.
• „Auka komma á undan lokasviganum“: Þetta gerist þegar síðasta stak í hlut eða fylki er með kommu á eftir sér, sem er ekki leyfilegt í staðlaðri JSON-málskipan.
• „Lyklar hluta verða að vera innan tvöfaldra gæsalappa“: Í JSON verða allir lyklar að vera strengir afmarkaðir með tvöföldum gæsalöppum.
• „Tvípunkt vantar á eftir heiti eiginleika“: Lykill og gildi verða alltaf að vera aðskilin með tvípunkti.
• „Streng vantar lokagæsalappir“: Ef strengur er opnaður en ekki lokaður á réttan hátt.
• „JSON-ið endar of snemma — það virðist vera skorið af“: Skjalið er ófullkomið, oft vegna þess að sviga vantar í lokin.
• „Óvæntur stafur þar sem gildi ætti að vera“: Ógildir stafir eða rög málskipan á stöðum þar sem búist er við gögnum.
• „Þetta JSON er of djúpt hreiðrað til að vinna úr því“: Gögnin fara yfir leyfileg mörk á dýpt hreiðrunar.
• „Tvítekinn lykill {key} — fjarlægðu annan áður en þú sníðir“: Tólið krefst þess að allir lyklar í sama hlut séu einstakir til að koma í veg fyrir að gögn renni saman eða glatist.

Ef gögnin eru ógild birtir trjásýnin skilaboðin „Lagaðu JSON-gögnin til að skoða þau sem tré.“. Tólið varðveitir stórar heiltölur nákvæmlega án þess að þær glatist eða rúnnist við vinnslu.

Stuðningur við óstaðlað JSON og sjálfvirk lagfæring

Tólið getur greint og lagfært ýmis skyld snið eða algeng frávik frá JSON-staðlinum. Þegar slík gögn eru numin býður tólið upp á hnappinn „Forskoða lagfæringu“ sem opnar gluggann „Forskoðun lagfæringar“. Þar má sjá samanburð á „Upprunalegt“ og „Eftir lagfæringu“. Ef lagfæringin nær yfir allt skjalið gæti birst tilkynningin „Forskoðunin er stytt — lagfæringin nær til alls skjalsins.“.

Eftirfarandi snið eru numin sjálfkrafa:

Notendur geta einnig valið á milli „JSON“ og „JSONC“ í valmyndinni „Málskipan“. Þegar lagfæringu er beitt með „Beita lagfæringu“ birtast skilaboðin „Lagfæringu var beitt. Ýttu á Ctrl/Cmd+Z til að afturkalla.“. Ef sjálfvirk lagfæring er ómöguleg birtir tólið „Ekki tókst að lagfæra þetta inntak sjálfkrafa.“.

Snyrting, röðun og smækkun gagna

Tólið býður upp á þrjár meginleiðir til að meðhöndla JSON-gögn: snyrtingu, röðun lykla og smækkun.

1. Snyrting: Með því að smella á „Sníða“ er gögnunum raðað upp með völdum inndrætti (valmöguleiki undir „Inndráttur“). Við þetta birtast skilaboðin „JSON sniðið.“.
2. Röðun lykla: Hnappurinn „Raða lyklum“ raðar lyklum hluta endurkvæmt eftir kóðapunktaröð, en röð fylkja breytist aldrei. Við þessa aðgerð birtast skilaboðin „Lyklum hefur verið raðað — röð fylkja er óbreytt. Ýttu á Ctrl/Cmd+Z til að afturkalla.“.
3. Smækkun: Með því að smella á „Smækka“ eru öll óþörf bil, línubil og inndrættir fjarlægð til að lágmarka gagnastærð. Við þetta birtast skilaboðin „JSON smækkað.“.

Hægt er að hreinsa ritilinn hvenær sem er með því að smella á „Hreinsa“, sem gefur skilaboðin „Ritill hreinsaður.“.

Skoðun og leit í trjásýni

Auk þess að skoða gögnin sem texta í „Kóði“ sýn, er hægt að skipta yfir í „Tré“ sýn til að skoða gagnaskipulagið á gagnvirkan hátt undir merkinu „JSON-tré“. Í trjásýninni er hægt að leita í gögnunum með leitarreitnum „Leita í lyklum og gildum“.

Leitin sýnir fjölda samsvarana á sniðinu „{current} af {total}“ eða „{current} af {total}+“ ef niðurstöður eru takmarkaðar. Ef engar niðurstöður finnast birtist „Engar samsvaranir“. Notendur geta flakkað á milli niðurstaðna með „Fyrri samsvörun“ og „Næsta samsvörun“.

Hægt er að stjórna birtingu trésins með hnöppunum „Opna allt“ og „Fella allt saman“. Fyrir einstaka hnúta má nota „Opna {key}“ og „Fella {key} saman“. Ef hægrismellt er á hnút eða valmynd opnuð birtist „Afritunarvalkostir fyrir {key}“ þar sem hægt er að velja:

• „Afrita gildi“: Afritar gildið sjálft.
• „Afrita JSON Pointer“: Afritar slóðina samkvæmt RFC 6901 staðlinum.
• „Afrita JSONPath“: Afritar slóðina á JSONPath-sniði.

Rótarnóðan í trénu er alltaf auðkennd með heitinu „rót“.

Takmarkanir og meðhöndlun stórra skráa

Tólið vinnur með ákveðin stærðarmörk til að tryggja stöðugleika í vafranum:

• Hámarksstærð inntaks: Hámarkið er 10 MiB. Ef farið er yfir það birtist „Inntakið er stærra en {limit}, sem er meira en þetta tól ræður við.“.
• Samhæfð vinnsla: Ef inntakið fer yfir 250.000 stafi vinnur tólið gögnin ósamfasa. Ef athugunin tekur of langan tíma stöðvast hún og sýnir „Athugun á þessu JSON tók of langan tíma og var stöðvuð. Prófaðu minna skjal.“.
• Takmarkanir á trjásýni: Ef skjalið er of stórt birtist „Þetta JSON er of stórt til að birta sem tré.“ eða „Þetta JSON hefur of mörg gildi til að birta sem tré.“. Þegar stór tré eru opnuð getur birst tilkynningin „Þetta JSON er of stórt til að opna að fullu — fyrstu {count} línurnar eru sýndar.“ ásamt hnappi til að „Sýna {count} í viðbót…“.

Skráainntak og flutningur gagna

Hægt er að hlaða inn skrám með því að smella á „Opna skrá“ eða draga þær yfir svæðið „Slepptu.json- eða.txt-skrá hér“. Við innlestur gilda eftirfarandi reglur og villuboð:

• Skráartegund: Aðeins .json eða .txt eru leyfðar. Annars birtist „Óstudd skráartegund — veldu.json- eða.txt-skrá.“.
• Stærðartakmörk: Ef skráin er of stór birtist „Skráin er of stór — hámarkið er {limit}.“.
• Kóðun: Skrár verða að vera á UTF-8 sniði. Ef svo er ekki birtist „Þessi skrá er ekki UTF-8-texti og því er ekki hægt að opna hana hér.“.
• Lestrarvilla: Ef upp kemur villa við lestur birtist „Ekki tókst að lesa skrána. Reyndu að velja hana aftur.“.

Þegar skrá hefur verið hlaðin inn birtast skilaboðin „{name} ({size}) var hlaðið inn.“. Hægt er að sækja unnin gögn með því að smella á „Sækja“, sem gefur tilkynninguna „{name} var sótt.“. Einnig er hægt að afrita niðurstöðuna á klippiborðið, sem staðfest er með „Afritað á klippiborð.“. Ef reynt er að framkvæma aðgerð án gagna birtist „Límdu eða opnaðu fyrst eitthvert JSON.“.

Algengar spurningar (FAQ)

Er JSON-gögnunum mínum hlaðið upp?
Nei. Snyrtirinn keyrir í vafranum þínum og sendir ekki JSON-gögnin þín neitt. JSON-gögnin þín eru unnin í vafranum þínum og ekkert er sent til BroBroGo.

Hvað gerir smækkun?
Smækkun (minify) fjarlægir óþarfa bil og línubil en varðveitir sömu JSON-gögn.

Hvaða skráarsnið get ég opnað í tólinu?
Þú getur opnað skrár með endingunum .json eða .txt. Skrárnar verða að vera UTF-8 kóðaðar og innan leyfilegra stærðarmarka.

Hvers vegna fæ ég villu um tvítekna lykla?
Tólið leyfir ekki tvítekna lykla í sama hlut til að koma í veg fyrir að gögn renni saman eða glatist við snyrtingu. Þú verður að fjarlægja tvítekna lykla áður en hægt er að sníða skjalið.