Konvertera mellan JSON och YAML

Detta verktyg omvandlar ett YAML-dokument till JSON och vice versa, samtidigt som datastrukturen bevaras (objekt, arrayer, skalära typer). Konverteringen från JSON till YAML, eller YAML till JSON, är en vanlig operation i utveckling: man genererar en OpenAPI YAML-fil från en JSON-spec, konverterar utdata från ett REST-API till YAML för att committa det i ett konfigurationsrepo, översätter ett Kubernetes-manifest från YAML till JSON för att skicka det till kubectl --dry-run=client -o json, eller anpassar ett GitHub Actions-workflow till ett JSON-schema. Mer generellt är det bryggan mellan datautbytesvärlden (JSON) och världen för manuell konfigurationsredigering (YAML).

JSON och YAML adresserar närliggande behov men olika användningsfall. Tabellen nedan sammanfattar de viktigaste tekniska skillnaderna, användbart för att välja mellan de två beroende på sammanhang.

JSON tar över så snart ett program pratar med ett annat program. Dess typiska användningsfall:

• REST- och GraphQL-API:er: payload för förfrågan och svar.
• Datautbyte mellan mikrotjänster och meddelandeköer.
• Nativ JavaScript-kod: JSON.parse och JSON.stringify utan beroende.
• Lagring på klientsidan: localStorage, sessionStorage, IndexedDB.
• AJAX-förfrågningar och fetch.
• Binära eller strömorienterade varianter: BSON (MongoDB), JSON Lines (loggar, ML-dataset), MessagePack.
• Konfiguration för JS / TS-verktyg: package.json, tsconfig.json, composer.json.

YAML tar över så snart en människa regelbundet redigerar filen. Dess typiska användningsfall:

• Docker Compose (docker-compose.yml) och stackprofiler.
• Kubernetes-manifest (Deployment, Service, Ingress, Helm charts).
• Ansible-playbooks och inventories.
• CI/CD-pipelines: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI / Swagger- och AsyncAPI-specifikationer.
• Annoterad applikationskonfiguration (Symfony, Spring Boot, Rails) där kommentarer är användbara.
• Filer som ofta redigeras för hand, där koncis och läslighet är viktigare än parse-hastighet.

YAML är mer tillåtande än JSON, vilket gör det till ett kraftfullt men förrädiskt format. De vanligaste fallgroparna:

• Indentering: tabbar är förbjudna enligt specifikationen, endast mellanslag är giltiga. Att blanda dessa eller ändra antalet mellanslag i samma block bryter parsingen.
• Automatisk typkonvertering av skalärer: yes, no, on, off, true, false, null, None, ~ parsas som booleaner eller null. Fallgropsexempel: ett postnummer 01234 utan citattecken blir heltalet 1234, och ett landsnamn NO (Norge) blir false. Sätt alltid tvetydiga strängar inom citattecken.
• Flerradssträngar: | (block literal) behåller radbrytningar som de är, medan > (folded) ersätter radbrytningar med mellanslag. Chomping-indikatorerna - och + justerar beteendet på den sista radbrytningen.
• YAML 1.1 vs 1.2: 1.1 (fortfarande mycket spridd, till exempel via PyYAML som standard) behandlar yes/no/on/off som booleaner, vilket 1.2 har tagit bort. Beteenden skiljer sig också för tal i bas 8.
• Implicita datum: 2024-01-15 utan citattecken tolkas som ett datumobjekt av vissa parsers, inte som en sträng.

Samma dokument, uttryckt i JSON och sedan i YAML. Enkel konfiguration av en applikation med dess beroenden och miljö:

JSON-version

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Motsvarande YAML-version

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

YAML-versionen är cirka 25 % kortare i tecken, accepterar en kommentar i toppen och läses som en lista över egenskaper utan syntaktiskt brus.

Steg för att konvertera dina data:

1. Klistra in ditt källdokument (JSON eller YAML) i inmatningsfältet.
2. Välj önskad konverteringsriktning (JSON till YAML eller YAML till JSON).
3. Klicka på konverteringsknappen: det formaterade resultatet visas i utdataområdet.
4. Verifiera resultatet och använd sedan kopieringsknappen för att hämta det till ditt urklipp.

Konverteringen utförs lokalt i din webbläsare eller via en dedikerad serverrutt beroende på tooling: ingen känslig data sparas.