Kokių tipų JSON klaidas aptinka šis įrankis?

Pagal RFC 8259 JSON specifikaciją įrankis aptinka trūkstamus kablelius, nesuderintus skliaustus / laužtinius skliaustus, netinkamas eilučių eilutes, pasibaigiančius kablelius, eilutes su kabutėmis ir kitus sintaksės pažeidimus.

Ar gali tvarkyti labai didelius JSON failus?

Taip. Formatavimo priemonė apdoroja JSON jūsų naršyklėje naudodama savąjį „JavaScript“ analizavimą, todėl efektyviai tvarko iki kelių megabaitų failus. Itin didelių failų (50 MB+) apdorojimo laikas priklauso nuo jūsų įrenginio.

Ar palaiko JSON su komentarais (JSONC)?

Standartinis JSON neleidžia komentuoti. Jei jūsų įvestyje yra komentarų, tikrintuvas pažymės juos kaip klaidas. Jei norite palaikyti JSONC, prieš formatuodami pašalinkite komentarus.

Ar formatavimas pakeis mano duomenų reikšmes?

Ne. Formatavimas koreguoja tik tarpą ir įtrauką – duomenų tipai, reikšmės ir struktūra išlieka visiškai tokie patys.

Ar palaikomos JSON5 funkcijos (komentarai, kableliai)?

Ne. Formatuotojas griežtai laikosi RFC 8259. JSON5 funkcijos sukelia analizavimo klaidas. Norėdami dirbti su JSON5, pirmiausia konvertuokite į standartinį JSON naudodami JSON5 analizatorių.

Ar mano JSON įkeltas į serverį?

Ne. Nagrinėjama ir formatuojama tik jūsų naršyklėje naudojant įtaisytąsias JSON funkcijas.

Ar dideli skaičiai praras tikslumą?

„JavaScript“ vaizduoja skaičius kaip 64 bitų slankiuosius duomenis, todėl sveikieji skaičiai, viršijantys 2^53 (apie 9 kvadrilijonus), praranda tikslumą. ID ar kitų didelių sveikųjų skaičių reikšmes išsaugokite kaip eilutes JSON.

Ar galiu rūšiuoti raktus abėcėlės tvarka?

JSON.stringify nerūšiuoja raktų. Naudokite atskirą rūšiavimo veiksmą (arba formatavimo priemonę su rūšiavimo palaikymu), kad suskirstytumėte raktus abėcėlės tvarka prieš sugrupuodami.

Nemokamas konverteris

JSON formatu & Tikrinimo priemonė

Formatuokite, gražinkite ir patvirtinkite JSON akimirksniu savo naršyklėje. Įkelti nereikia – visiškai privatu ir nemokama.

Įklijuokite JSON čia

Nuvilkite JSON failą čia

Palaiko .json failus. Arba įklijuokite JSON į aukščiau esančią sritį.

Arba

Apie šį įrankį

JSON formatavimas (dažnai vadinamas gražiu spausdinimu arba gražinimu) naudoja kompaktišką JSON ir prideda tarpų – eilučių lūžių, įtraukų, nuoseklių tarpų – kad struktūra būtų matoma skaitytojams. Kompaktiškas JSON yra tinkamas perdavimo formatas: jis sumažina baitus per laidą ir saugyklą. Suformatuotas JSON yra tinkamas tikrinimo formatas: įtraukta hierarchija vienu žvilgsniu atskleidžia įdėtą struktūrą, suteikia skirtumų prasmės ir leidžia kūrėjams rasti konkrečius laukus neanalizuojant dokumento.

Šis formatuotojas išanalizuoja įvestį kaip JSON, kad patvirtintų, jog ji tinkama, tada iš naujo išsiunčia ją su nuoseklia įtrauka. Neteisinga įvestis sukuria klaidą, nurodantį sintaksės problemą. Tinkama įvestis suformatuojama iš naujo, neatsižvelgiant į tai, koks kompaktiškas ar netvarkingas buvo šaltinis. Įtrauka pagal numatytuosius nustatymus yra du tarpai, atitinkantys dažniausiai pasitaikančias „JavaScript“ taisykles.

Formatuotojas taip pat siūlo sumažinimą (atvirkštinę operaciją), kuri pašalina visas nereikalingas tarpas, kad būtų sukurtas mažiausias tinkamas JSON. Sumažinta produkcija naudinga produkcijos perdavimui; suformatuota išvestis yra naudinga kuriant ir derinant.

Kodėl formatuoti JSON

Skaityti giliai įdėtą JSON be įtraukos iš esmės neįmanoma – struktūra yra techniškai, bet nematoma. Net ir vidutiniškai sudėtingas JSON formatavimas turi didžiulę naudą. Kodo tikrintojams, API derintojams ir visiems, bandantiems suprasti naudingą duomenų apkrovą, reikia suformatuoti JSON, kad pamatytų, kas ten yra.

Formatuojant taip pat užfiksuojamos klaidos. Jei JSON nepavyksta išanalizuoti formatuojant, klaidos pranešimas nurodo tikslią sintaksės problemos vietą – dažnai trūkstamas kablelis, raktas be kabutės arba paklydęs kablelis, kurio kūrimo sistema nepažymėjo. Formatuotojas yra paprasčiausias JSON patvirtinimo įrankis.

Kaip naudoti

Įklijuokite JSON, spustelėkite formatą.

Įklijuokite JSON: Į įvesties sritį įklijuokite neapdorotą arba kompaktišką JSON. Taip pat veikia ir .json failų vilkimas.
Pasirinkite įtrauką: Pagal nutylėjimą yra 2 tarpai. Naudokite 4 tarpus projektams, kurie atitinka tą susitarimą, arba skirtukus, jei to reikia tolesniems įrankiams.
Formatas: Įvestis išanalizuojama naudojant JSON.parse, kad būtų patvirtintas galiojimas, tada nuosekliai sujungiama naudojant JSON.stringify ir pasirinktą įtrauką. Įvesties klaidos pateikia analizavimo klaidos pranešimą, nurodantį problemos vietą.
Nukopijuokite arba atsisiųskite: Nukopijuokite suformatuotą JSON į mainų sritį arba išsaugokite kaip .json. Išvestis yra struktūriškai identiška įvesties, bet su nuosekliais tarpais.

Įprasto naudojimo atvejai

API atsakymų skaitymas kūrimo metu — API atsakymų, grąžintų kaip kompaktiškas JSON, beveik neįmanoma nuskaityti. Formatuojant atskleidžiama derinimo struktūra.
JSON palyginimas versijų valdymo skirtumuose — Kompaktiškas JSON sukuria beprasmius vienos eilutės skirtumus. Formatavimas prieš įsipareigojimą paverčia skirtumus struktūriniais ir peržiūrimi.
Greitas JSON patvirtinimas — Įklijuojant įtartiną JSON į formatavimo įrenginį, sintaksės klaidos užfiksuojamos naudojant naudingus padėties indikatorius greičiau nei paleidžiant jį per kodo analizatorių.
Kuriamas skaitomas JSON dokumentacijai — Pavyzdiniai naudingieji kroviniai dokumentuose geriau skaitomi suformatuoti. Kompaktiškas JSON mokymo programose klaidina skaitytojus.
JSON ruošiamas saugoti versija valdomuose failuose — Konfigūracijos failai, skirti git, turėtų būti suformatuoti taip, kad būsimi skirtumai būtų prasmingi.

Techninės detalės

Formatuotojas naudoja JSON.parse ir JSON.stringify – tą pačią porą, kuri pristatoma kiekviena „JavaScript“ vykdymo programa. Nagrinėjama pagal RFC 8259 (dabartinė JSON specifikacija), priimant griežtą JSON, bet atmetant JavaScript objektų raides, komentarus, galinius kablelius ir kitus JSON5 plėtinius.

JSON.stringify priima įtraukos argumentą: skaičių (tarpus) arba eilutę (tinkintą įtraukos simbolį, pvz., skirtuką). Formatuotojas atskleidžia abi parinktis. Išvestis rūšiuojama pagal objektų šaltinio tvarką (nes ES2015 išsaugojo nuosavybės įterpimo tvarką visuose pagrindiniuose varikliuose).

Kraštiniai atvejai: dideli skaičiai, viršijantys Number.MAX_SAFE_INTEGER, praranda tikslumą analizuojant (žinomas JSON apribojimas; naudokite eilučių reikšmes ID, kurie viršija 2^53). Unikodo pabėgimai eilutėse išsaugomi tiesiogine prasme. Iš kiekvienos eilutės pašalinami tarpai.

Geriausia praktika

Daugeliui projektų naudokite 2 tarpų įtrauką — Jis atitinka JavaScript ir daugumą šiuolaikinių konvencijų. 4 erdvės yra priimtinos projektams, kurie pageidauja platesnės įtraukos.
Suformatuokite prieš įsipareigodami naudoti git — Suformatuotas JSON versijos valdiklyje sukuria skaitomus skirtumus. Jei dažnai dirbate su JSON failais, pridėkite išankstinio patvirtinimo kabliuką, kad užtikrintumėte susitarimą.
Patvirtinkite prieš siųsdami — Jei JSON surenkate rankiniu būdu, prieš siųsdami jį į API, paleiskite jį per formatuotoją, kad pastebėtumėte sintaksės klaidas.
Sumažinti gamybos perdavimui — Gamybos API naudingosioms apkrovoms naudingas sumažintas JSON, kad būtų sumažintas pralaidumas. Formatuokite tik kūrimo kopijas.

Dažnai užduodami klausimai

Kokių tipų JSON klaidas aptinka šis įrankis?: Pagal RFC 8259 JSON specifikaciją įrankis aptinka trūkstamus kablelius, nesuderintus skliaustus / laužtinius skliaustus, netinkamas eilučių eilutes, pasibaigiančius kablelius, eilutes su kabutėmis ir kitus sintaksės pažeidimus.
Ar gali tvarkyti labai didelius JSON failus?: Taip. Formatavimo priemonė apdoroja JSON jūsų naršyklėje naudodama savąjį „JavaScript“ analizavimą, todėl efektyviai tvarko iki kelių megabaitų failus. Itin didelių failų (50 MB+) apdorojimo laikas priklauso nuo jūsų įrenginio.
Ar palaiko JSON su komentarais (JSONC)?: Standartinis JSON neleidžia komentuoti. Jei jūsų įvestyje yra komentarų, tikrintuvas pažymės juos kaip klaidas. Jei norite palaikyti JSONC, prieš formatuodami pašalinkite komentarus.
Ar formatavimas pakeis mano duomenų reikšmes?: Ne. Formatavimas koreguoja tik tarpą ir įtrauką – duomenų tipai, reikšmės ir struktūra išlieka visiškai tokie patys.
Ar palaikomos JSON5 funkcijos (komentarai, kableliai)?: Ne. Formatuotojas griežtai laikosi RFC 8259. JSON5 funkcijos sukelia analizavimo klaidas. Norėdami dirbti su JSON5, pirmiausia konvertuokite į standartinį JSON naudodami JSON5 analizatorių.
Ar mano JSON įkeltas į serverį?: Ne. Nagrinėjama ir formatuojama tik jūsų naršyklėje naudojant įtaisytąsias JSON funkcijas.
Ar dideli skaičiai praras tikslumą?: „JavaScript“ vaizduoja skaičius kaip 64 bitų slankiuosius duomenis, todėl sveikieji skaičiai, viršijantys 2^53 (apie 9 kvadrilijonus), praranda tikslumą. ID ar kitų didelių sveikųjų skaičių reikšmes išsaugokite kaip eilutes JSON.
Ar galiu rūšiuoti raktus abėcėlės tvarka?: JSON.stringify nerūšiuoja raktų. Naudokite atskirą rūšiavimo veiksmą (arba formatavimo priemonę su rūšiavimo palaikymu), kad suskirstytumėte raktus abėcėlės tvarka prieš sugrupuodami.

JSON formatu & Tikrinimo priemonė

Nuvilkite JSON failą čia

Susiję įrankiai

XML formatuotojas & Tikrinimo priemonė

Pakeitimų žurnalas Formatuotojas

Dummy JSON API Frontend testavimui

GraphQL užklausa Formatuotojas

Apie šį įrankį

Kodėl formatuoti JSON

Kaip naudoti

Įprasto naudojimo atvejai

Techninės detalės

Geriausia praktika

Dažnai užduodami klausimai

Related Articles

Essential Developer Tools: JSON, Base64, RegEx, and More

Hashing, Encryption, and Encoding Explained: A Developer's Security Guide

Spreadsheet & Data Conversion Guide: Excel, CSV, JSON, and More

Why Browser-Based Tools Are the Future: No Installs, No Uploads, No Risk