Convertisseur JSON vers YAML

À propos de cet outil

Le lien entre les deux formats

JSON et YAML décrivent le même genre de données : des dictionnaires, des listes, des chaînes, des nombres, des booléens et null. YAML 1.2 a été conçu pour que JSON en soit un sous-ensemble, et ajoute ce dont un fichier édité à la main a besoin : des commentaires, l'indentation à la place des accolades et des crochets, des chaînes multilignes, plusieurs documents dans un même fichier, et des ancres avec des alias pour réutiliser une valeur.

Passer de JSON à YAML conserve toutes les valeurs, à une exception près : une clé qui apparaît deux fois dans le même objet ne garde que sa dernière valeur, car un dictionnaire YAML ne peut pas répéter une clé. Passer de YAML à JSON ne conserve que les données : les commentaires disparaissent, les alias et les clés de fusion << sont remplacés par les valeurs auxquelles ils renvoient, les tags personnalisés comme !Ref sont supprimés mais leurs valeurs restent, et les clés qui ne sont pas des chaînes, comme 1 ou true, deviennent leur texte.

Les pièges de YAML à connaître

Le problème de la Norvège. En YAML 1.1, les mots yes, no, on et off sans guillemets sont des booléens : une liste de codes pays contenant no se retrouve donc avec false. YAML 1.2 ne garde que true et false. Le parseur de cet outil suit YAML 1.2, sauf si le document commence par une directive %YAML 1.1 : il lit donc no comme la chaîne « no ». Beaucoup de parseurs encore utilisés appliquent les règles de la 1.1 : quand cet outil écrit du YAML, il met donc ces chaînes entre guillemets.

Les numéros de version. Un 1.10 sans guillemets est un nombre à virgule flottante, et en tant que nombre il vaut 1.1. Les numéros de version, les codes postaux et tout ce qui ne fait que ressembler à un nombre doivent être mis entre guillemets pour rester du texte : version: "1.10".

Comment cet outil convertit

Le côté que vous avez modifié en dernier sert de source, et l'autre côté est réécrit à partir de lui. Si la source ne peut pas être analysée, l'erreur s'affiche en dessous et l'autre côté conserve la dernière conversion valide. Les options d'indentation s'appliquent au côté généré ; changer l'indentation JSON réindente aussi le JSON que vous avez saisi, alors que le YAML que vous avez saisi n'est jamais réécrit, car cela supprimerait ses commentaires.

Les clés restent dans l'ordre de la source, y compris les clés composées de chiffres, qu'un objet JavaScript placerait en tête. Les entiers supérieurs à 2 puissance 53 sont recopiés chiffre par chiffre dans les deux sens. Un fichier YAML contenant plusieurs documents séparés par --- devient un tableau JSON, et la page le signale. Une clé utilisée deux fois dans un même dictionnaire YAML est signalée comme une erreur. Le YAML est lu et écrit par le package open source yaml, qui s'exécute dans votre navigateur.