Skip to content

JSON formatuotojas

Įklijuokite JSON, kad iš karto suformatuotumėte, patikrintumėte ir pagražintumėte su sintaksės paryškinimu.

JSON formatuotojas ir validatorius

Tuščia
Įklijuokite arba įkelkite JSON žemiau, kad pradėtumėte.
Įvestis Įklijuoti · vilkti · įkelti · URL
Išvestis
Suformatuota

        
        
      

Tipiniai pavyzdžiai

Spustelėkite kortelę, kad įkeltumėte turinį į redaktorių.

Kas yra JSON ir kaip veikia šis įrankis

JSON (JavaScript Object Notation) — tai lengvas tekstinis formatas struktūrizuotiems duomenims. Jis naudoja šešis reikšmių tipus — string, number, boolean, null, object (raktinį žemėlapį) ir array (sutvarkytą sąrašą) — ir jį palaiko praktiškai visos programavimo kalbos.

Šis įrankis nagrinėja jūsų įvestį naudodamas naršyklės savąjį JSON.parse, tada perpiešia ją dviem būdais. Formatuoti gražiai išspausdina su pasirinkta įtrauka (numatytasis 2 tarpai). Suspausti sukuria trumpiausią galiojančią išvestį — naudinga įterpiant į URL, konfigūracijos reikšmes ar tikrinimų atvaizdus. Medžio vaizde matomi sulankstomi mazgai ir vienu spustelėjimu kopijuojami JSON keliai ($.data.users[0].name), kuriuos galima įklijuoti į jq, JMESPath ar Postman testavimo skriptus.

Raktų rūšiavimo perjungiklis sukuria nuoseklią raktų tvarką, kad du tos pačios turinio turiniai būtų lyginami vienodai. Pasikartojantys raktai jūsų įvestyje rodomi kaip įspėjimas — JSON specifikacija jų nedraudžia, bet nagrinėtojai tyliai išlaiko tik paskutinį pasirodymą, o tai dažna klaidų priežastis.

Dažnos JSON klaidos

Netikėtas simbolis ,
Galinis kablelis po paskutinio elemento. Pašalinkite paskutinį kablelį — JSON jų neleidžia (skirtingai nei JavaScript ar JSON5).
[1, 2, 3,]
[1, 2, 3]
Netikėtas simbolis '
Eilutės turi naudoti dvigubas kabutes, įskaitant raktus. Pakeiskite vienkubes kabutes dvigubomis visur.
{'name': 'Ada'}
{"name": "Ada"}
Netikėtas identifikatorius
Objekto raktai turi būti su kabutėmis. {name: "x"} yra galiojantis JavaScript, bet ne JSON.
{name: "Ada"}
{"name": "Ada"}
Netikėta įvesties pabaiga
Skliaustelis ar riestinis skliaustelis nebuvo uždarytas. Suskaičiuokite atvėrimus ir uždarymus — medžio vaizdo lankstymo rodyklės padeda tai pastebėti.
{"a": [1, 2
{"a": [1, 2]}
Blogas valdymo simbolis
Tiesioginė nauja eilutė ar tabuliacija eilutės viduje. Pabėkite jas su \n / \t arba naudokite kitų eilučių formatą.
{"msg": "line1
line2"}
{"msg": "line1\nline2"}
Pasikartojantis raktas (įspėjimas)
Techniškai negalima negaliojanti, bet JSON.parse išlaiko tik paskutinę reikšmę — tylus duomenų praradimas. Pervadinkite ar sujunkite raktus.
{"id": 1, "id": 2}
{"ids": [1, 2]}

Pavyzdžiai

Kaip tai veikia

JSON (JavaScript Object Notation) — tai lengvas duomenų mainų formatas, tapęs interneto API, konfigūracijos failų ir duomenų saugojimo standartu. Jis nepriklauso nuo kalbos, lengvai skaitomas žmonių ir lengvai nagrinėjamas bei generuojamas mašinų.

Galiojantis JSON laikosi griežtų sintaksės taisyklių: visi raktai turi būti dvigubomis kabutėmis apvilktos eilutės, reikšmės gali būti eilutės, skaičiai, loginės reikšmės, null, masyvai ar sulizdinti objektai. Galiniai kableliai po paskutinio elemento neleidžiami, o komentarai nėra standarto dalis. Šios taisyklės daro JSON nedviprasmišką — bet kuris atitinkantis nagrinėtojas vienodai interpretuos tuos pačius duomenis.

Gražus išspausdinimas prideda įtraukas ir eilučių pertraukas, kad JSON būtų skaitomas. Suspaudimas pašalina visus nereikalingus tarpus, kad sumažintų failo dydį perdavimui. Šis įrankis išnagrinėja jūsų JSON, patikrina jį pagal specifikaciją ir vėl serializuoja su sintaksės paryškinimu, kad galėtumėte tikrinti struktūrą, pastebėti klaidas ir kopijuoti švarią išvestį.

Patarimai ir geroji praktika

Visada naudokite dvigubas kabutes: vienkubės kabutės JSON formate negalioja. Tiek raktai, tiek eilučių reikšmės turi būti su dvigubomis kabutėmis ("key", o ne 'key').
Jokių galinių kablelių: kablelis po paskutinio elemento masyve ar objekte yra sintaksės klaida. Pašalinkite jį, kitaip jūsų JSON nebus išnagrinėtas.
Patikrinkite prieš siunčiant: visada patikrinkite JSON validatoriumi prieš siųsdami į API. Trūkstama kabutė ar papildomas kablelis gali sukelti tylias klaidas.
Komentarai neleidžiami: standartinis JSON nepalaiko komentarų. Jei reikia komentarų konfigūracijos failuose, naudokite JSONC (JSON su komentarais) arba JSON5.
Raktai turi būti unikalūs: tame pačiame objekto lygyje kiekvienas raktas turėtų pasirodyti tik kartą. Pasikartojantys raktai sukelia nenuspėjamą elgesį — dauguma nagrinėtojų išlaiko paskutinę reikšmę.

Dažniausiai užduodami klausimai

Kas yra JSON?

JSON (JavaScript Object Notation) — tai lengvas, tekstinis duomenų formatas, naudojamas struktūrizuotiems duomenims saugoti ir keistis. Jis naudoja raktų-reikšmių poras ir masyvus, lengvai skaitomas žmonių ir yra standartinis interneto API bei konfigūracijos failų formatas.

Įklijuokite JSON į formatuotoją, ir jis automatiškai patikrins sintaksės klaidas. Galiojantis JSON bus suformatuotas su tinkama įtrauka. Jei netinkamas, įrankis paryškins tikslią eilutę ir simbolį, kur įvyksta klaida.

Dažniausios klaidos: galiniai kableliai po paskutinio elemento objekte ar masyve, vienkubių kabučių naudojimas vietoj dvigubų, raktai be kabučių, trūkstami kableliai tarp elementų ir komentarų įtraukimas (JSON nepalaiko komentarų).

JSON yra griežtesnis už JavaScript objektus: raktai turi būti su dvigubomis kabutėmis, reikšmės negali būti funkcijos ar undefined, o galiniai kableliai neleidžiami. JSON yra duomenų formatas, o JavaScript objektai — programavimo konstrukcijos.

Standartinis JSON nepalaiko komentarų. Jei reikia komentarų konfigūracijos failuose, apsvarstykite JSONC (JSON su komentarais, naudojamas VS Code) arba JSON5, kuris išplečia JSON komentarais, galiniais kableliais ir raktais be kabučių.

JSON Schema — tai specifikacija JSON duomenų struktūrai, tipams ir apribojimams apibrėžti. Ji leidžia patikrinti, ar JSON dokumentas atitinka tikėtiną formatą — pavyzdžiui, reikalauti tam tikrų laukų buvimo ar apriboti reikšmes konkrečiais tipais.

JSON neturi savojo datos tipo. Dažniausia konvencija — naudoti ISO 8601 eilutes (pvz., „2024-01-15T09:30:00Z"). Unix laiko žymos (sekundės ar milisekundės nuo epochos) taip pat populiarios. Visada dokumentuokite, kokį formatą naudoja jūsų API.

Pats JSON dydžio apribojimo neturi, bet praktinės ribos priklauso nuo nagrinėtojo ir aplinkos. JavaScript JSON.parse() gali apdoroti kelių šimtų megabaitų failus. Labai dideliems duomenų rinkiniams apsvarstykite srautinius nagrinėtojus arba formatus kaip NDJSON (eilutėmis atskirtas JSON).

JSON yra kompaktiškesnis ir lengviau nagrinėjamas nei XML. JSON naudoja raktų-reikšmių poras ir masyvus, o XML — sulizdintas žymas su atributais. JSON yra dominuojantis interneto API formatas dėl savo paprastumo, o XML vis dar naudojamas įmonių sistemose, SOAP paslaugose ir dokumentų formatuose.

Gražus išspausdinimas prideda įtraukas, eilučių pertraukas ir tarpus į suspaustą JSON, kad jis būtų skaitomas žmonėms. Suspaustas JSON pašalina visus nereikalingus tarpus, kad sumažintų failo dydį perdavimui. Abu reprezentuoja tuos pačius duomenis — skirtumas tik vizualinis.