TypeScript Academy · Lezione

Tipi per i valori JSON

Definisca un tipo completo e type-safe per i valori JSON.

Tipi per i valori JSON è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.

Che cos'è un valore JSON?

JSON consente un insieme fisso di forme di valori: stringhe, numeri, valori booleani, null, array e oggetti. Un tipo ricorsivo può descrivere esattamente questo insieme.

type Json =
  | string
  | number
  | boolean
  | null
  | Json[]
  | { [k: string]: Json };
// arrays and objects nest Json again.

Il tipo JSON ricorsivo

L'intuizione fondamentale è che gli array contengono Json e i valori degli oggetti sono Json, quindi il tipo fa riferimento a sé stesso per i dati annidati.

type Json =
  | string | number | boolean | null
  | Json[]
  | { [k: string]: Json };
const x: Json = { name: "Ada", tags: ["a", "b"], active: true };
console.log(x);

Valori JSON primitivi

I valori JSON più semplici sono primitivi. Ognuno può essere assegnato direttamente a Json.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const a: Json = "hello";
const b: Json = 42;
const c: Json = true;
const d: Json = null;
console.log(a, b, c, d);

Array JSON

Un array JSON è Json[], quindi può contenere una combinazione di qualsiasi valore JSON, inclusi array e oggetti annidati.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const arr: Json = [1, "two", true, null, [3, 4]];
console.log(Array.isArray(arr));

Oggetti JSON

Un oggetto JSON associa chiavi stringa a valori Json tramite una firma di indice, consentendo un annidamento arbitrario.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const obj: Json = {
  user: { name: "Ada", age: 36 },
  scores: [10, 20, 30]
};
console.log(obj);

JSON profondamente annidato

Poiché il tipo è ricorsivo, le strutture profondamente annidate sono tipizzate completamente senza dichiarazioni aggiuntive.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const deep: Json = {
  a: { b: { c: [1, { d: true }] } }
};
console.log(deep);

Cosa esclude JSON

Il tipo Json rifiuta correttamente i valori che JSON non può rappresentare, come undefined, le funzioni o gli oggetti Date.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
// const bad: Json = undefined; // Error
// const fn: Json = () => 1;   // Error
const good: Json = { ok: true };
console.log(good);

Convalidare le forme JSON a runtime

Il tipo descrive un JSON valido, ma deve comunque convalidare a runtime gli input non attendibili. Un controllo ricorsivo verifica ogni livello.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
function isJson(v: unknown): v is Json {
  if (v === null) return true;
  const t = typeof v;
  if (t === "string" || t === "number" || t === "boolean") return true;
  if (Array.isArray(v)) return v.every(isJson);
  if (t === "object") return Object.values(v as object).every(isJson);
  return false;
}
console.log(isJson({ a: [1, 2], b: "x" }));

Analizzare in un tipo Json

JSON.parse restituisce any, quindi esegua il cast del risultato analizzato a Json solo dopo averlo convalidato, oppure tipizzi la variabile e la convalidi.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const raw = "{ \"id\": 1, \"tags\": [\"a\"] }";
const parsed = JSON.parse(raw) as Json;
console.log(parsed);

Attraversare un valore Json

Un attraversatore ricorsivo può attraversare qualsiasi valore JSON, gestendo primitivi, array e oggetti tramite il controllo della forma a runtime.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
function countLeaves(v: Json): number {
  if (Array.isArray(v)) return v.reduce((a, x) => a + countLeaves(x), 0);
  if (v !== null && typeof v === "object") return Object.values(v).reduce((a, x) => a + countLeaves(x), 0);
  return 1;
}
console.log(countLeaves({ a: [1, 2], b: "x" }));

Perché il tipo Json è utile

Un tipo Json preciso documenta esattamente cosa può oltrepassare il confine della Sua API, rilevando in fase di compilazione i tentativi di serializzare valori non JSON.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
function send(payload: Json): string {
  return JSON.stringify(payload);
}
console.log(send({ ok: true, items: [1, 2, 3] }));

Verifica rapida: tipi di valori JSON

Verifichi la Sua comprensione dei tipi di valori JSON.

Riepilogo: tipi di valori JSON

Ha definito un tipo ricorsivo Json che comprende primitivi, array e oggetti, ha imparato cosa esclude e ha convalidato input non attendibili con un controllo ricorsivo dei tipi.

type Json = string | number | boolean | null | Json[] | { [k: string]: Json };
const data: Json = { id: 1, tags: ["a", "b"] };
console.log(JSON.stringify(data));

Domande Frequenti

La lezione «Tipi per i valori JSON» è gratuita?

Sì — il testo completo di «Tipi per i valori JSON» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.

Cosa imparerò in «Tipi per i valori JSON»?

Definisca un tipo completo e type-safe per i valori JSON. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Tipi per i valori JSON»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a TypeScript Academy