Come convertire YAML in JSON

Panoramica

Questo strumento serve a trasformare testo YAML in testo JSON, utile quando devi passare una configurazione o una struttura di dati a un sistema che richiede JSON. Puoi incollare il contenuto YAML nell’area di input e scegliere come rendere leggibile il risultato. La conversione interpreta la struttura dei dati: supporta mappature, mappature annidate e sequenze, quindi non si limita a liste o coppie chiave-valore semplici.

Il risultato è testo JSON, non una copia dell’aspetto originale del documento YAML. Commenti, virgolette e impaginazione di presentazione non vanno quindi considerati elementi da conservare. Se il testo contiene più documenti YAML separati secondo la sintassi prevista, il risultato può essere un array JSON quando restano più documenti non nulli.

Procedura

Prepara il testo YAML da convertire. Verifica che l’indentazione sia coerente e che la sintassi sia completa, soprattutto nei blocchi annidati e nelle sequenze.
Incolla il contenuto nel campo di input. Il campo accetta testo YAML; se lo lasci vuoto, anche un input composto solo da spazi viene elaborato come un oggetto JSON vuoto.
Avvia la conversione. Lo strumento analizza il YAML e produce testo JSON. Se il documento contiene una struttura a più livelli o una sequenza, controlla che la gerarchia risultante rifletta i dati inseriti.
Imposta l’indentazione JSON secondo la leggibilità che ti serve. Il valore predefinito è 2, ma puoi configurare l’indentazione. Se devi confrontare o uniformare più risultati, puoi anche attivare l’ordinamento delle chiavi; questa opzione è disattivata in modo predefinito.
Usa il risultato JSON nel contesto previsto e controllalo prima di salvarlo o trasferirlo. Con più documenti YAML, considera la forma del risultato: se rimangono più documenti non nulli, viene restituito un array; se ne rimane uno solo, viene restituito quel documento, mentre se non ne rimane alcuno viene restituito un oggetto JSON vuoto.

Come leggere il risultato

Un risultato riuscito è testo JSON ottenuto dai valori interpretati nel documento YAML. L’indentazione modifica la presentazione del testo, mentre l’ordinamento delle chiavi modifica l’ordine delle chiavi negli oggetti quando l’opzione è attiva; nessuna delle due impostazioni cambia il fatto che l’output sia JSON.

Un input vuoto non indica un errore: produce un oggetto JSON vuoto. Al contrario, un YAML malformato porta a una conversione non riuscita e non a un output JSON riuscito. Può inoltre verificarsi un esito non riuscito se il valore interpretato non può essere serializzato come JSON.

Per i documenti multipli, non aspettarti necessariamente un array: questa forma compare solo quando restano più documenti non nulli. La conversione riguarda YAML in ingresso e JSON in uscita; non è descritta come conversione inversa o come conservazione della formattazione originale.

Esempio pratico

Hai una configurazione YAML con il nome di un servizio e una sequenza di ruoli e vuoi ottenere JSON da usare in un sistema che accetta quel formato.

Incolla il testo YAML nella casella di input, avvia la conversione e controlla il testo JSON prodotto; poi imposta l’indentazione desiderata se vuoi una presentazione diversa.

Dopo la conversione, il risultato ha la forma di un oggetto JSON con una proprietà testuale e una proprietà array contenente i valori della sequenza.

Limiti

Un YAML malformato o un valore che non può essere serializzato in JSON producono una conversione non riuscita, senza output JSON riuscito.
La conversione descritta riguarda esclusivamente testo YAML in ingresso e testo JSON in uscita; non sono verificate funzioni per altri formati o per la conversione inversa.

Errori comuni

Se la conversione non riesce, la causa può essere una sintassi YAML malformata. Correggi l’indentazione e i delimitatori del testo, poi riprova con il documento aggiornato.

Domande frequenti

Quali strutture YAML posso convertire in JSON?

Sì, purché il contenuto sia YAML valido e il valore interpretato possa essere serializzato in JSON. Mappature, strutture annidate e sequenze rientrano negli esempi verificati.

Che cosa succede se lascio vuoto il campo YAML?

Sì: l’input vuoto o composto solo da spazi viene elaborato con esito riuscito e produce un oggetto JSON vuoto.

Un file YAML con più documenti produce sempre un array JSON?

Dipende dal numero di documenti non nulli rimasti dopo l’elaborazione: con più documenti il risultato è un array JSON; con uno solo viene restituito quel documento, mentre senza documenti non nulli viene prodotto un oggetto JSON vuoto.