JSON-syöte

Tarkistustulos

Mikä on JSON-tarkistin?

Lähetät API-pyynnön ja saat takaisin JSON:ia, jota koodisi kieltäytyy jäsentämästä. Tai muokkaat tsconfig.json-tiedostoa ja build hajoaa salaperäiseen "unexpected token" -virheeseen. Molemmat johtuvat samasta ongelmasta: JSON:lla on tiukat syntaksisäännöt, jotka on yllättävän helppo rikkoa — loppukommat, yksittäiset lainausmerkit kaksinkertaisten sijaan, lainausmerkkittömät avaimet tai puuttuva sulku haudattuna kolme tasoa syvälle. JSON-tarkistaja tarkistaa, onko tekstisi hyvin muodostettu JSON-määrittelyn mukaan — ja kun jokin on pielessä, se osoittaa tarkan rivin ja merkin.

Tämä työkalu käyttää JSON.parse()-funktiota selaimessasi. Kelvollinen syöte tuottaa onnistumisviestin; virheellinen syöte näyttää jäsennysvirheen. Mitään dataa ei lähetetä palvelimelle.

Miten työkalua käytetään

1

Liitä tai lataa

Liitä JSON vasempaan editoriin tai lataa tiedosto. Käytä Kelvollinen esimerkki- tai Virheellinen esimerkki -painiketta nähdäksesi molemmat lopputulokset.

2

Tarkista tulos

Oikea paneeli näyttää Kelvollinen tai Virheellinen sekä virhetiedot. Yläosan merkki kertoo tilan yhdellä silmäyksellä.

3

Korjaa ja tarkista uudelleen

Jos JSON on virheellinen, korjaa ilmoitettu ongelma ja tarkistin päivittyy automaattisesti. Käytä Kopioi ottaaksesi tuloksen talteen. Muotoiltua tulostetta varten kokeile JSON-muotoilutyökalua.

Missä JSON-validointi auttaa

Useimmat kehittäjät tarvitsevat validointia lukiessaan API-vastauksia. Lähetät pyynnön Postmanin tai curlin kautta, ja vastaus saattaa olla virheellinen — katkaistu, väärin muotoiltu tai HTML-kääritty. Liittämällä sen tähän näet heti, onko JSON hyvin muodostettua ennen kuin kirjoitat jäsennyslogiikan. Tiettyjen arvojen poimimiseen kelvollisesta JSON:sta jq toimii hyvin komentorivillä.

Asetustiedostot kuten package.json tai tsconfig.json, joissa on kirjoitusvirhe, voivat rikkoa buildit. Ajamalla ne tämän kautta löydät syntaksivirheet ennen käyttöönottoa. Tietokantavientidata, webhook-kuormat ja lokimerkinnät tarvitsevat usein myös validoinnin. Jos haluat muotoilla kelvollisen JSON:n luettavuuden parantamiseksi, käytä JSON-muotoilutyökalua.

JSON-validoinnin esimerkkejä

Kelvollinen JSON noudattaa tiukkaa syntaksia. Tässä telecom-aiheisia esimerkkejä:

Kelvollinen JSON (tilaajatietue)

Kelvollinen

Virheellinen JSON (lainausmerkkitön avain, loppukomma)

Virheellinen

Käytä Kelvollinen esimerkki- tai Virheellinen esimerkki -painiketta ladataksesi nämä editoriin.

Yleiset JSON-virheet

Loppukommat ovat yleisin virhe. {"a": 1,} on virheellinen. Samoin [1, 2, 3,]. Ominaisuuksien nimet täytyy laittaa kaksoislainausmerkkeihin; {a: 1} epäonnistuu. Yksittäiset lainausmerkit merkkijonoissa eivät ole sallittuja. JSON.parse() -dokumentaatio listaa hyväksytyt muodot.

Tämä tarkistin tarkistaa vain syntaksin. Se ei validoi skeemaa vasten (esim. pakollisia kenttiä tai tietotyyppejä). Käytä siihen JSON-schema-generaattoria skeeman luomiseen, sitten validoi muualla. JSON Schema -sivustolla on lisää skeemavalidoinnista.

Usein kysyttyä

Lähetetäänkö JSON:ni minnekään?

Ei. Validointi toimii selaimessasi. Mitään ei ladata.

Entä jos virheilmoitus on epäselvä?

JavaScriptin jäsennysvirheet voivat olla kryptisiä. Katso rivin ja sarakkeen numeroa. Yleisiä korjauksia: poista loppukommat, käytä kaksoislainausmerkkejä avaimille ja merkkijonoille, tarkista puuttuvat } tai ].

Tukeeko tämä JSON5:tä tai JSONC:tä?

Ei. Se noudattaa tiukkaa JSON:ia. Laajennukset kuten JSON5 (kommentit, loppukommat) tai JSONC epäonnistuvat tässä.

Voinko validoida skeeman?

Tämä työkalu validoi vain syntaksin. Skeemavalidointia varten luo skeema JSON-schema-generaattorilla ja käytä kirjastoa tai muuta JSON Schema -tukeista työkalua.

Miksi API:ni palauttaa virheellistä JSON:ia?

Joskus vastaus on katkaistu, siinä on BOM tai se sisältää ei-JSON-tekstiä (esim. virhe-HTML). Tarkista raakavastaus Postmanissa tai DevToolsissa. Merkkijono JSONiksi -työkalu voi auttaa pakotettujen merkkijonojen kanssa.

Liittyvät työkalut

Syvemmälle JSON:iin: MDN:n JSON-opas ja JSON.parse(). Virallinen määrittely: RFC 8259. JSON-määrittely json.orgissa määrittelee kieliopin. Skeemavalidointiin: JSON Schema. Katso myös jq ja Postman.