JSON-muotoilija

JSON-tietojen merkitys ja käsittely selaimessa

JSON (JavaScript Object Notation) on vakiintunut tiedonsiirtomuoto, jota käytetään laajasti sovellusliittymien (API) vastauksissa, konfiguraatiotiedostoissa ja järjestelmien välisessä tiedonvaihdossa. Vaikka JSON on suunniteltu sekä koneiden että ihmisten luettavaksi, koneellisesti tuotettu JSON on usein pakattua ja vaikeasti hahmotettavaa. JSON-muotoilija tarjoaa työkalut tämän datan muotoiluun, validointiin ja muuntamiseen suoraan verkkoselaimessa.

Tietoturva ja yksityisyys ovat kriittisiä tekijöitä käsiteltäessä konfiguraatioita tai API-vastauksia. JSON-tietosi käsitellään selaimessasi. Mitään ei lähetetä BroBroGo-palvelimelle. Tämä tarkoittaa, että syöttämäsi tiedot eivät poistu omalta laitteeltasi, eikä niitä siirretä verkon yli ulkopuolisille palvelimille.

Syötteiden hallinta ja tiedostorajoitukset

Työkalu vastaanottaa JSON-dataa useilla eri tavoilla käyttäjän tarpeen mukaan:

• Liitetty teksti: Voit liittää JSON-koodin suoraan syötealueelle.
• Tiedostojen avaaminen: Voit avata .json- tai .txt-tiedoston napsauttamalla painiketta tai vetämällä ja pudottamalla tiedoston käyttöliittymään.
• Syntaksin valinta: Voit valita syntaksiksi joko standardin mukaisen "JSON"-vaihtoehdon tai kommentteja tukevan "JSONC"-vaihtoehdon.
• Sisennyksen määritys: Voit valita haluamasi sisennystason muotoilua varten.

Tiedostojen ja syötteiden käsittelyssä noudatetaan tarkkoja teknisiä rajoituksia ja sääntöjä suorituskyvyn varmistamiseksi:

• Tiedostokoko: Tiedostoille on asetettu kokoraja. Jos tiedosto on liian suuri, työkalu näyttää virheen: "Tiedosto on liian suuri — raja on {limit}.".
• Tiedostotyyppi: Vain .json- ja .txt-tiedostot hyväksytään. Muussa tapauksessa näytetään ilmoitus: "Tiedostotyyppiä ei tueta — valitse.json- tai.txt-tiedosto.".
• Merkistökoodaus: Tiedostojen on oltava UTF-8-koodattuja. Jos näin ei ole, näytetään virhe: "Tämä tiedosto ei ole UTF-8-tekstiä, joten sitä ei voi avata tässä.".
• Lukuvirheet: Jos tiedostoa ei voida lukea, järjestelmä ilmoittaa: "Tiedoston lukeminen epäonnistui. Yritä valita se uudelleen.".
• Yleinen syöteraja: Jos syötteen koko ylittää 10 MiB maksimirajan, työkalu ilmoittaa: "Syöte on suurempi kuin {limit}, mikä on enemmän kuin tämä työkalu pystyy käsittelemään.".
• Suorituskyvyn aikakatkaisu: Jos JSON-tietojen tarkistus kestää liian kauan, prosessi keskeytetään ja näytetään ilmoitus: "Tämän JSONin tarkistus kesti liian kauan ja se keskeytettiin. Kokeile pienempää dokumenttia.".

JSON-syntaksin validointi ja virheiden korjaus

Validointi varmistaa, että JSON-rakenne noudattaa virallisia syntaksisääntöjä. Työkalu tunnistaa virheet reaaliaikaisesti ja ilmoittaa niiden sijainnin muodossa "rivi {line}, sarake {col}". Käyttäjä voi siirtyä suoraan virhekohtaan "Siirry virheeseen" -painikkeella.

Työkalu tunnistaa seuraavat yleiset syntaksivirheet:

• "Pilkku puuttuu kohteiden välistä"
• "Ylimääräinen pilkku ennen sulkevaa suljetta"
• "Objektin avainten on oltava lainausmerkeissä"
• "Kaksoispiste puuttuu ominaisuuden nimen jälkeen"
• "Merkkijonosta puuttuu sulkeva lainausmerkki"
• "JSON päättyy liian aikaisin — se näyttää katkenneelta"
• "Odottamaton merkki kohdassa, jossa pitäisi olla arvo"
• "Tämä JSON on liian syvästi sisäkkäinen käsiteltäväksi"
• "Kaksoisavain {key} — poista toinen ennen muotoilua" (työkalu ei sulata tai hylkää kaksoisavaimia hiljaisesti, vaan antaa niistä virheen).

Automaattinen korjaus ja esikatselu

Jos syöte ei ole standardia JSON-muotoa, työkalu pystyy tunnistamaan useita ei-standardeja rakenteita ja tarjoamaan niihin korjaustoimenpiteitä:

Käyttäjä voi tarkastella ehdotettuja muutoksia painamalla "Esikatsele korjaus" -painiketta, jolloin avautuu "Korjauksen esikatselu" -näkymä. Tässä näkymässä näytetään rinnakkain "Alkuperäinen" ja "Korjauksen jälkeen" -versiot. Jos korjaus hyväksytään "Käytä korjausta" -painikkeella, työkalu ilmoittaa: "Korjaus tehty. Kumoa painamalla Ctrl/Cmd+Z.". Jos automaattinen korjaus ei ole mahdollinen, näytetään ilmoitus: "Tätä syötettä ei voitu korjata automaattisesti.". Jos korjaus on erittäin laaja, esikatseluun voi ilmestyä huomautus: "Esikatselu on katkaistu — korjaus vaikuttaa koko dokumenttiin.".

Muotoilu, järjestäminen ja minifointi

Työkalu tarjoaa kaksi ensisijaista tapaa muuttaa JSON-tekstin rakennetta: muotoilu ja minifointi.

Muotoilu ja avainten järjestäminen

Muotoilu parantaa luettavuutta lisäämällä rivinvaihtoja ja sisennyksiä valitun tason mukaisesti. Muotoilun yhteydessä suuret kokonaisluvut säilytetään tarkasti ilman pyöristysvirheitä tai datan menetystä.

Käyttäjä voi myös järjestää objektien avaimet aakkosjärjestykseen "Järjestä avaimet" -painikkeella. Painikkeen työkaluvihje tarkentaa toiminnon: "Järjestää objektien avaimet rekursiivisesti koodipistejärjestykseen. Taulukoiden järjestys ei koskaan muutu.". Kun järjestäminen on suoritettu, näytetään ilmoitus: "Avaimet järjestetty — taulukoiden järjestys ennallaan. Kumoa painamalla Ctrl/Cmd+Z.".

Minifointi

Minifointi on muotoilun vastakohta. Se poistaa JSON-datasta kaikki tarpeettomat välilyönnit, sisennykset ja rivinvaihdot, jolloin tiedostokoko pienenee. Tämä on hyödyllistä tiedonsiirron ja tallennustilan optimoinnissa. Minifoinnin jälkeen käyttöliittymässä näytetään ilmoitus: "JSON minifoitu.".

Navigointi puunäkymässä ja tietojen poiminta

Monimutkaisen ja syvän JSON-rakenteen tutkimiseen työkalu tarjoaa interaktiivisen "Puu"-näkymän perinteisen "Koodi"-näkymän rinnalle. Jos JSON on virheellinen, puunäkymää ei voida muodostaa, ja näytölle tulee ilmoitus: "Korjaa JSON nähdäksesi sen puunäkymänä.".

Puunäkymän ominaisuudet ja rajoitukset:

• Kokorajoitukset: Erittäin suurille tiedostoille puunäkymää ei voida muodostaa suorituskykysyistä, jolloin näytetään ilmoitus: "Tämä JSON on liian suuri esitettäväksi puunäkymänä." tai "Tässä JSONissa on liikaa arvoja puunäkymää varten.".
• Solmujen laajentaminen: Käyttäjä voi laajentaa tai supistaa solmuja painikkeilla "Laajenna kaikki" ja "Supista kaikki". Suurissa tiedostoissa laajennusta rajoitetaan ilmoituksella: "Tämä JSON on liian suuri laajennaksi kokonaan — näytetään ensimmäiset {count} riviä.". Yksittäisiä solmuja voi hallita painikkeilla "Laajenna {key}" ja "Supista {key}".
• Haku: Puunäkymässä on hakukenttä "Hae avaimista ja arvoista". Hakutulosten määrä näytetään muodossa "{current} / {total}" tai rajoitetuissa tapauksissa "{current} / {total}+". Jos osumia ei ole, näytetään "Ei osumia". Hakutulosten välillä voi liikkua painikkeilla "Edellinen osuma" ja "Seuraava osuma".

Tietojen poiminta (JSON Pointer ja JSONPath)

Puunäkymän solmujen kohdalla on käytettävissä valikko "Kopiointivaihtoehdot kohteelle {key}". Valikosta voi valita seuraavat kopiointitavat:

1. Kopioi arvo: Kopioi valitun solmun sisältämän arvon sellaisenaan.
2. Kopioi JSON Pointer: Kopioi RFC 6901 -standardin mukaisen polun kohteeseen (esim. /juuri/solmu/0).
3. Kopioi JSONPath: Kopioi JSONPath-lausekkeen, jota käytetään yleisesti datan suodattamiseen kyselyissä.

Usein kysytyt kysymykset (FAQ)

Lähetetäänkö JSON-tietoni palvelimelle?
Ei. Muotoilutyökalu toimii selaimessasi eikä lähetä JSON-tietojasi verkkoon. Kaikki muotoilu, validointi ja korjaustoimenpiteet tapahtuvat paikallisesti käyttäjän omalla laitteella.

Mitä minifointi tekee?
Minifointi poistaa tarpeettomat välilyönnit ja rivinvaihdot säilyttäen saman JSON-datan. Toiminto pienentää dokumentin kokoa siirtoa ja tallennusta varten.

Miten työkalu käsittelee suuria lukuja?
Työkalu säilyttää suuret kokonaisluvut tarkasti ilman pyöristymistä tai datan menetystä muotoiluprosessin aikana.

Miksi puunäkymä ei aukea?
Puunäkymän avaaminen edellyttää, että JSON on täysin syntaksiltaan kelvollinen. Jos tiedostossa on virheitä, näytetään ilmoitus "Korjaa JSON nähdäksesi sen puunäkymänä.". Puunäkymää ei myöskään voida muodostaa, jos JSON-dokumentti ylittää sille asetetun kokorajan.