Formatēt un atkāpt JSON

Vadības panelis
Dokumentācija
API

padara JSON kodu lasāmu un strukturētu, atvieglojot datu apmaiņas lasīšanu starp serveriem un lietojumprogrammām

Kāpēc JSON formatējums?

JSON formatējums palīdz izstrādātājiem padarīt JSON datus lasāmākus un saprotamākus un lietotājiem. Tas jo īpaši atvieglo atkļūdošanu, koda pārskatīšanu un datu analīzi strādājot ar sarežģītiem un lieliem JSON failiem. Var būt arī labi formatēts JSON vieglāk integrēt dokumentos un pārskatos.

Kā formatēt JSON

Formatēšanas lapā varat formatēt savu JSON, ielīmējot to norādītajā tekstlodziņā. efektu vai augšupielādējot failu, kurā ir JSON.

Uui

Tiklīdz JSON tiks iesniegts, tas tiks formatēts un parādīts rezultātu lodziņā. Ja JSON nav derīgs, tiks parādīta kļūda ar norādi par problēmas būtību.

Izmantojiet formatētu JSON

Varat kopēt formatēto JSON, izmantojot šim nolūkam paredzēto kopēšanas pogu. Tas atvieglos integrējot JSON savos projektos vai pārskatos.

Jūsu JSON kodam vajadzētu izskatīties šādi:


{
    "id": 12345,
    "vārds": "Džons Dū",
    "email": "johndoe@example.com",
    "adrese": {
        "iela": "123 Main St",
        "pilsēta": "Springfield",
        "state": "IT",
        "pasta kods": "62704",
        "valsts": "ASV"
    },
    "phoneNumbers": [
        {
            "tips": "mājas",
            "numurs": "555-1234"
        },
        {
            "tips": "darbs",
            "numurs": "555-5678"
        }
    ],
    "pasūtījumi": [
        {
            "orderId": 1001,
            "orderDate": "2023-06-01T14:30:00Z",
            "preces": [
                {
                    "productId": 2001,
                    "productName": "Klēpjdators",
                    "daudzums": 1,
                    "cena": 999,99,
                    "detaļas": {
                        "ražotājs": "TechCorp",
                        "garantija": "2 gadi"
                    }
                },
                {
                    "productId": 2002,
                    "productName": "Pele",
                    "daudzums": 2,
                    "cena": 25,50,
                    "detaļas": {
                        "manufacturer": "GadgetCo",
                        "garantija": "1 gads"
                    }
                }
            ],
            "kopējāSumma": 1051,49
        },
        {
            "orderId": 1002,
            "orderDate": "2023-06-10T10:15:00Z",
            "preces": [
                {
                    "productId": 2003,
                    "productName": "Tastatūra",
                    "daudzums": 1,
                    "cena": 45,99,
                    "detaļas": {
                        "ražotājs": "KeyMasters",
                        "garantija": "3 gadi"
                    }
                }
            ],
            “kopējā summa”: 45,99
        }
    ],
    "preferences": {
        "biļetens": taisnība,
        "paziņojumi": {
            "e-pasts": patiess,
            "sms": nepatiess
        },
        "tēma": "tumšs"
    },
    "lastLogin": "2024-06-14T09:30:00Z"
}

Bieži uzdotie jautājumi

Kāda ir atšķirība starp JSON formatētāju, pārbaudītāju un minifikatoru?

Formatētājs (izdaiļotājs) pārraksta kompakto JSON atkāpes un lasāmā versijā. Validators tikai pārbauda, vai sintakse atbilst specifikācijai (RFC 8259), un ziņo par kļūdām. Minifikators darbojas pretēji formatētājam: tas noņem visas atstarpes, lai samazinātu faila lielumu. Mūsu rīks apvieno formatējumu un validāciju: ja JSON ir nederīgs, kļūdas ziņojums norāda problēmas atrašanās vietu.

Vai standarta JSON pieņem komentārus un beigu komatus?

Nē. JSON specifikācija (RFC 8259) stingri aizliedz komentārus (// vai /* */) un beigu komatus aiz pēdējā masīva vai objekta elementa. Ja jums tas ir nepieciešams, skatiet JSON5 vai JSONC — divus paplašinājumus, kas pieņem komentārus un beigu komatus, ko jo īpaši izmanto VS Code un TypeScript konfigurācijas faili.

Kāpēc virknēs jāizmanto pēdiņas?

JSON specifikācija pieprasa dubultpēdiņas (") visām virknēm un visām objektu atslēgām. Vienpēdiņas (') nav derīgas, pat ja JavaScript tās akceptē. Kopējot no JS koda, bieži sastopama kļūda ir atstāt vienas pēdiņas: formatētājs pēc tam ziņo par parsēšanas kļūdu.

Kā rīkoties ar lieliem vai ļoti precīziem decimālskaitļiem?

JSON neatšķir veselus skaitļus no peldošā komata skaitļiem: viss ir skaitlis. JavaScript parsētāji automātiski pārvērš par skaitli, kas zaudē precizitāti, kas pārsniedz 2^53 (veselus skaitļus), un peldošā komata precizitāte ir ierobežota līdz 15 nozīmīgiem cipariem. Gariem identifikatoriem (Twitter ID, Discord sniegpārslām) vai finanšu summām, lai saglabātu precizitāti, iekodējiet tos virknē ("123456789012345678").

Kuru atkāpi izvēlēties: 2 vai 4 atstarpes?

2 atstarpju atkāpe ir dominējošā vienošanās (Prettier, ESLint pēc noklusējuma, npm konvencijas), tā joprojām ir lasāma pat ļoti ligzdotiem dokumentiem. 4 atkāpju atkāpe ir piemērota plakaniem dokumentiem, kur vertikālums palīdz lasīt. Galvenais ir konsekvence viena projekta ietvaros. Mūsu rīks pēc noklusējuma izmanto 4 atstarpes, kas atbilst skaistajai json_encode(JSON_PRETTY_PRINT) izdrukai PHP.

Kas man jādara, ja manā JSON ir unikoda rakstzīmes vai emocijzīmes?

JSON sākotnēji atbalsta UTF-8. Emocijas, akcenti, CJK rakstzīmes un citi raksti, kas nav latīņu rakstzīmes, tiek saglabāti formatētajā izvadē. Ja jūsu JSON izmanto Unikoda atsoļošanu (é — é), tā paliek derīga, taču formatētājs to nepārraksta uz sākotnējo rakstzīmi. Lai normalizētu, izmantojiet stingru parsētāju, piemēram, JSON.parse, kam seko JSON.stringify.

Pieprasījuma piemērs

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

Ievades shēma

Lauks	Tips	Obligāts	Noklusējums
`input`	text	✓	–

Endpoint

GET https://cdrn.fr/api/v1/tools - uzskaita visus pieejamos rīkus
GET https://cdrn.fr/api/v1/tools/json-formatter - iegūst šī rīka shēmu
POST https://cdrn.fr/api/v1/tools/json-formatter/execute - izpilda šo rīku ar JSON payload