Gjør JSON lesbart på nett
Lim inn et API-svar, en konfigurasjonsfil eller en logglinje og les innholdet ordentlig. Objekter og tabeller får innrykk etter dybde, én nøkkel per linje og syntaksutheving i resultatet.
Hvorfor JSON kommer komprimert
JSON er det vanlige språket for API-er, og API-er prioriterer byte fremfor lesbarhet. Et svar fra et REST-endepunkt eller en GraphQL-tjener serialiseres uten et eneste mellomrom. Det passer godt for nettverket, men dårlig for den som skal lese det. Det samme gjelder konfigurasjonsfiler som verktøy skriver til kodelageret, strukturerte logglinjer, JSON-LD-blokker innebygd i en side og innhold du kopierer fra nettverksfanen i utviklerverktøyene.
Formatering gjør strukturen tydelig
JSON med innrykk gir raske svar på spørsmål om strukturen. Hvor dypt går dette objektet? Er feltet en tabell med objekter eller et objekt med tabeller? Hvilken nøkkel er null der du forventet en verdi, og hvor slutter én oppføring og den neste begynner? Det tar sekunder å finne en manglende eller feilstavet nøkkel i formaterte data, mens det samme arbeidet på én lang linje ofte ender med at du skriver et skript i stedet. En praktisk gjennomgang starter med en kjent oppførings-ID. Finn verdien, undersøk objektet den tilhører, og sammenlign de relevante nøklene med datakontrakten applikasjonen forventer. Skill mellom en manglende nøkkel, en eksplisitt null-verdi og en tom tabell, siden applikasjoner ofte håndterer dem forskjellig. Formatering gjør forskjellene synlige, men kontrollerer ikke forretningsregler, finner ikke alle problemer med dupliserte nøkler og verifiserer ikke API-kontrakter. Bruk applikasjonstester og skjemavalidering til slike kontroller etter at du har funnet den mistenkelige delen av dataene.
Ugyldig JSON oppdages med en gang
Siden inndataene må tolkes før de kan skrives ut, er formatering også den raskeste gyldighetskontrollen du har. Et avsluttende komma, en streng i enkle anførselstegn, et anførselstegn uten escape-tegn inne i en verdi eller et avkortet svar stopper tolkingen og gir deg en feil i stedet for et resultat. Det er ofte slik man oppdager at API-svaret man feilsøkte, var avkortet, eller at en konfigurasjonsfil har ett komma for mye.
JSON, JSON Lines og JSONP
Denne siden formaterer ett enkelt JSON-dokument. Hvis inndataene dine er en loggfil med ett JSON-objekt per linje, formaterer du de enkelte linjene du er interessert i, i stedet for hele filen, siden filen som helhet ikke er et gyldig dokument. Og hvis et svar begynner med et funksjonsnavn som omslutter dataene, er det JSONP og ikke JSON, og det er nettopp derfor verktøyet noen ganger gjenkjenner en nyttelast som JavaScript. I så fall er gjenkjenningen riktig, og formatering som JavaScript gir likevel et fullt lesbart resultat.
Ofte stilte spørsmål
Validerer verktøyet JSON-dataene mine?
I praksis ja. Dokumentet må kunne tolkes før det kan formateres, så enhver syntaksfeil stopper behandlingen og rapporteres i stedet for et resultat. Det er den raskeste måten å kontrollere om en nyttelast er velformet på.
Beholdes rekkefølgen på nøklene?
Formatereren sorterer ikke objektnøkler med hensikt. Målet er å gjøre strukturen du oppgir, enklere å lese. Behold originalen når den nøyaktige teksten er viktig, siden formatering kan endre oppsett og representasjon. Nøkkelrekkefølgen alene bekrefter heller ikke at dataene følger skjemaet applikasjonen forventer.
Kan jeg formatere svært store API-svar?
Tilgjengelig minne og prosessorkraft i nettleseren avgjør hva som er praktisk. Store svar kan gjøre fanen treg eller få den til å fryse under formatering og syntaksutheving, og ingen bestemt størrelse er garantert støttet. Begynn med et mindre, komplett objekt eller en tabell når du undersøker én oppføring i et stort svar.