Formatirati in zamakniti JSON

Nadzorna plošča
Dokumentacija
API

naredi JSON kodo berljivo in strukturirano, olajša branje podatkovnih izmenjav med strežniki in aplikacijami

Zakaj formatiranje JSON?

Oblikovanje JSON pomaga, da so podatki JSON bolj berljivi in razumljivi za razvijalce in uporabniki. To zlasti olajša odpravljanje napak, pregled kode in analizo podatkov pri delu s kompleksnimi in velikimi datotekami JSON. Lahko je tudi dobro oblikovan JSON lažje vključiti v dokumente in poročila.

Kako formatirati JSON

Na strani za oblikovanje lahko svoj JSON formatirate tako, da ga prilepite v predvideno besedilno polje. ali z nalaganjem datoteke, ki vsebuje JSON.

Uui

Takoj ko je JSON predložen, bo oblikovan in prikazan v polju z rezultati. Če je JSON neveljaven, prikazana bo napaka z navedbo narave težave.

Uporabite formatiran JSON

Oblikovani JSON lahko kopirate s pomočjo gumba za kopiranje, ki je predviden za ta namen. To bo olajšalo integracijo JSON v vaše projekte ali poročila.

Vaša koda JSON bi morala izgledati takole:


{
    "id": 12345,
    "ime": "Janez Doe",
    "email": "johndoe@example.com",
    "naslov": {
        "ulica": "glavna ulica 123",
        "mesto": "Springfield",
        "state": "IT",
        "poštna številka": "62704",
        "država": "ZDA"
    },
    "telefonske številke": [
        {
            "vrsta": "dom",
            "številka": "555-1234"
        },
        {
            "vrsta": "delo",
            "številka": "555-5678"
        }
    ],
    "naročila": [
        {
            "ID naročila": 1001,
            "datum naročila": "2023-06-01T14:30:00Z",
            "predmeti": [
                {
                    "productId": 2001,
                    "productName": "Prenosni računalnik",
                    "količina": 1,
                    "cena": 999,99,
                    "podrobnosti": {
                        "proizvajalec": "TechCorp",
                        "garancija": "2 leti"
                    }
                },
                {
                    "productId": 2002,
                    "productName": "Miška",
                    "količina": 2,
                    "cena": 25,50,
                    "podrobnosti": {
                        "proizvajalec": "GadgetCo",
                        "garancija": "1 leto"
                    }
                }
            ],
            "skupni znesek": 1051,49
        },
        {
            "ID naročila": 1002,
            "datum naročila": "2023-06-10T10:15:00Z",
            "predmeti": [
                {
                    "productId": 2003,
                    "productName": "Tipkovnica",
                    "količina": 1,
                    "cena": 45,99,
                    "podrobnosti": {
                        "proizvajalec": "KeyMasters",
                        "garancija": "3 leta"
                    }
                }
            ],
            “totalAmount”: 45,99
        }
    ],
    "preferences": {
        "newsletter": res,
        "obvestila": {
            "e-pošta": res,
            "sms": napačno
        },
        "tema": "temno"
    },
    "lastLogin": "2024-06-14T09:30:00Z"
}

Pogosta vprašanja

Kakšna je razlika med oblikovalnikom, validatorjem in minifierjem JSON?

Oblikovalnik (polepšalnik) prepiše kompakten JSON v zamaknjeno in berljivo različico. Validator samo preveri, ali je sintaksa v skladu s specifikacijo (RFC 8259), in poroča o napakah. Minifier deluje nasprotno od oblikovalnika: odstrani vse presledke, da zmanjša velikost datoteke. Naše orodje združuje oblikovanje in preverjanje veljavnosti: če je JSON neveljaven, sporočilo o napaki določa položaj težave.

Ali standardni JSON sprejema komentarje in vejice na koncu?

Ne. Specifikacija JSON (RFC 8259) strogo prepoveduje komentarje (// ali /* */) in končne vejice za zadnjim elementom matrike ali predmeta. Če ga potrebujete, si oglejte JSON5 ali JSONC, dve razširitvi, ki sprejemata komentarje in končne vejice, ki ju uporabljajo zlasti konfiguracijske datoteke VS Code in TypeScript.

Zakaj bi morali nizi uporabljati dvojne narekovaje?

Specifikacija JSON zahteva dvojne narekovaje (") za vse nize in vse ključe objektov. Enojni narekovaji (') niso veljavni, tudi če jih JavaScript sprejema. Pogosta napaka pri kopiranju iz kode JS je, da pustite enojne narekovaje: oblikovalnik nato sporoči napako pri razčlenjevanju.

Kako ravnam z velikimi številkami ali zelo natančnimi decimalnimi številkami?

JSON ne razlikuje med celimi števili in števili s plavajočo vejico: vse je število. Razčlenjevalniki JavaScript samodejno pretvorijo v Number, ki izgubi natančnost nad 2^53 (cela števila) in ima natančnost s plavajočo vejico, omejeno na 15 pomembnih števk. Za dolge identifikatorje (ID-ji na Twitterju, snežinke Discord) ali finančne zneske jih kodirajte z nizi ("123456789012345678"), da ohranite natančnost.

Kateri zamik naj izberem: 2 ali 4 presledke?

Zamik z dvema presledkoma je prevladujoča konvencija (prettier, ESLint privzeto, konvencije npm), ostane berljiva tudi za zelo ugnezdene dokumente. Zamik s 4 presledki je primeren za ravne dokumente, kjer navpičnost olajša branje. Glavna stvar je doslednost znotraj istega projekta. Naše orodje privzeto uporablja 4 presledke, ki ustrezajo lepemu tisku json_encode(JSON_PRETTY_PRINT) v PHP.

Kaj naj naredim, če moj JSON vsebuje znake Unicode ali emojije?

JSON izvorno podpira UTF-8. Emojiji, naglasi, znaki CJK in druge nelatinične pisave so ohranjene, kot so v formatiranem izpisu. Če vaš JSON uporablja ubežne kode Unicode (é za é), ostane veljaven, vendar ga formater ne prepiše v izvorni znak. Za normalizacijo pojdite skozi strogi razčlenjevalnik, kot je JSON.parse, ki mu sledi JSON.stringify.

Primer zahteve

curl -X POST https://cdrn.fr/api/v1/tools/json-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Vhodna shema

Polje	Tip	Obvezno	Privzeto
`input`	text	✓	–

Končne točke

GET https://cdrn.fr/api/v1/tools - izpiše vsa razpoložljiva orodja
GET https://cdrn.fr/api/v1/tools/json-formatter - pridobi shemo tega orodja
POST https://cdrn.fr/api/v1/tools/json-formatter/execute - izvede to orodje s JSON payloadom