Help

YAML validator: controleer YAML terwijl je typt

Plak je YAML en deze YAML validator controleert het terwijl je typt. Elke syntaxfout wordt in gewone taal uitgelegd, met regel en kolom. Hij vindt inspringen met tabs, dubbele sleutels, niet gesloten aanhalingstekens en haakjes, en onzichtbare harde spaties die op inspringing lijken maar het niet zijn. Je YAML wordt in je eigen browser gecontroleerd en nooit geüpload.


YAML controleren: zo werkt de validator

Plak je YAML in het veld YAML of typ het daar. Er is geen knop om te controleren: de tekst wordt live gecontroleerd.

  1. Geplakte tekst wordt meteen gecontroleerd. Tijdens het typen start de controle ongeveer een kwart seconde na je laatste toets, bij heel grote tekst iets later. Het vorige resultaat blijft gedimd staan tot het nieuwe er is.
  2. Lees het vak onder de editor. Een groen vak Geldige YAML betekent dat de syntaxis klopt. Een rood vak Ongeldige YAML (of „Ongeldige YAML: N problemen”) somt op wat er mis is.
  3. Elk probleem geeft een zin, „Regel N, kolom M” en een fragment van de regel met regelnummers: twee regels erboven, één eronder en een ^ onder de kolom.
  4. Druk op Tonen in editor om die regel in het veld te selecteren. Herstel hem en zie het vak groen worden.

Per document wordt alleen de eerste syntaxfout gemeld. De fouten daarna zijn meestal bijeffecten, bijvoorbeeld een ontbrekend aanhalingsteken dat de regels eronder opslokt. Dubbele sleutels en niet-gedefinieerde aliassen worden altijd allemaal getoond. Er worden maximaal 20 problemen getoond.

YAML checker online: veelvoorkomende problemen en oplossingen

Elk probleem wordt in één zin uitgelegd in plaats van met een kale parsermelding. Dit zijn de meest voorkomende:

Wat foutmeldingen van andere parsers betekenen

Kom je hier vanuit een melding in je terminal of CI-log? Zo komen de gangbare formuleringen overeen met wat deze validator meldt. Plak hetzelfde bestand en hij toont de regel.

De formulering verschilt per parser (PyYAML, js-yaml, Ruby, Go, de loaders van Home Assistant en ESPHome), en een parser meldt vaak een regel onder de echte fout. Deze validator wijst naar de regel die hij je kan tonen.

Tabs en onzichtbare tekens

De twee moeilijkst te vinden YAML-fouten zijn de fouten die je niet ziet. Deze validator maakt ze zichtbaar.

Een voorbeeld: in een bestand met server: en daaronder port: 8080 begint de laatste regel, host: example.com, met twee harde spaties in plaats van twee spaties. YAML leest hem als een aparte sleutel op het hoogste niveau, en host hoort niet bij server. Het gele vak noemt het teken en de regel.

YAML formatteren en het resultaat kopiëren

Zet boven het veld de schakelaar YAML formatteren aan. Standaard staat hij uit. Is de tekst geldig, dan verschijnt een blok Geformatteerde YAML met erboven een knop Kopiëren, die na het kopiëren verandert in Gekopieerd. Het formatteren is voorspelbaar:

Alleen geldige YAML wordt geformatteerd, dus een kapot bestand repareert het niet: los eerst de fouten op. Heel lange uitvoer wordt na 600.000 tekens afgekapt getoond, en Kopiëren kopieert nog steeds alles.

YAML linter online: toepassingen, grootte en grenzen

De controle is hetzelfde waarvoor je YAML ook gebruikt. Hij werkt voor GitHub Actions-workflows, docker-compose.yml, Kubernetes-manifesten en Helm-waarden, OpenAPI-bestanden, Ansible-playbooks, de configuratie van Home Assistant, CloudFormation-sjablonen en mkdocs-configuratie. Plak het bestand voor je commit en de syntaxfouten verschijnen zonder te wachten op een CI-run. Een bestand met meerdere documenten gescheiden door --- wordt document voor document gecontroleerd, en het groene vak zegt hoeveel hij er vond. Ankers (&naam) en aliassen (*naam) worden gecontroleerd. Eigen tags zoals !Ref, !Sub en !GetAtt van CloudFormation, of !reference van GitLab, gelden als geldig.

De controle draait in een Web Worker in je browser. Gangbare configuratie-, CI- en Kubernetes-bestanden zijn in een oogwenk gecontroleerd. De limiet is 5.000.000 tekens, en een tekst dichtbij die grens duurt een paar seconden en kost veel geheugen. Daarboven word je gevraagd een kleiner stuk te plakken.

Alleen de YAML-syntaxis wordt gecontroleerd. Hij weet niet wat een bepaald programma verwacht, dus Kubernetes-velden, sleutels van GitHub Actions of Docker Compose en JSON-schemaregels worden niet gecontroleerd, en een verkeerd gespelde sleutelnaam komt er toch door. Hij volgt YAML 1.2, dus de YAML 1.1-woorden yes, no, on en off zijn gewone tekst en worden nooit beoordeeld. Hij voert niets uit, haalt niets op en laadt niets, en een los oud Mac-regeleinde (CR) telt niet als regeleinde.

Werk je met andere formaten? Maak JSON netjes en controleer het met JSON formatteren, toets het aan een schema met de JSON-schema validator, of controleer markup met de XML-validator. Zoek je een patroon in je configuratie? Probeer het in de Regex-tester.


Veelgestelde vragen

Hoe controleer ik YAML online?

Plak je YAML in het veld „YAML”. De tekst wordt gecontroleerd terwijl je plakt of typt, dus er is geen knop om op te drukken. Een groen vak „Geldige YAML” betekent dat de syntaxis klopt. Een rood vak „Ongeldige YAML” geeft elk probleem in gewone taal met „Regel N, kolom M” en een fragment van de regel.

Waarom zegt YAML dat tabs niet zijn toegestaan voor inspringen?

YAML staat alleen spaties toe om in te springen, en een tab aan het begin van een regel is een syntaxfout. Editors voegen vaak tabs in als je op de Tab-toets drukt, of een tab komt mee met geplakte tekst. De validator meldt dat de regel met een tab is ingesprongen. Vervang de tab door spaties.

Wat betekent „mapping values are not allowed here” in YAML?

Meestal staat er een tweede dubbele punt op een regel, zoals in „a: b: c”, of bevat een waarde zonder aanhalingstekens een dubbele punt. Het kan ook een regel zijn die inspringt onder een sleutel die al een waarde heeft. Zet de waarde tussen aanhalingstekens of schrijf het binnenste paar op een eigen ingesprongen regel.

Wat betekent „did not find expected key” in YAML?

Een regel sluit niet aan bij de andere sleutels van zijn mapping. Meestal heeft één sleutel een spatie meer of minder dan zijn buren. Geef alle sleutels op hetzelfde niveau dezelfde inspringing. De validator meldt dit als een regel die niet aansluit bij de andere sleutels.

Hoe vind ik dubbele sleutels in YAML?

Plak de tekst. Dubbele sleutels in dezelfde mapping worden altijd allemaal getoond, elk met regel en kolom. Meestal liet een gekopieerd blok een herhaalde sleutel achter. Voeg de items samen of verwijder het dubbele exemplaar.

Waarom toont een geldig YAML-bestand „Geldig, maar controleer deze regel”?

Een regel begint met een onzichtbare spatie, bijvoorbeeld een harde spatie. YAML leest die als deel van de sleutel, dus de regel springt niet echt in, ook al is het bestand geldig. Het gele vak noemt het teken en de regel. Verwijder het en typ gewone spaties.

Kan ik hier een YAML-bestand voor GitHub Actions, Docker Compose of Kubernetes controleren?

Ja, de syntaxiscontrole is voor elke YAML hetzelfde. Hij werkt voor workflows, docker-compose.yml, Kubernetes-manifesten en veel meer. Alleen de syntaxis wordt gecontroleerd: de validator weet niet welke sleutels elk programma verwacht, en een verkeerd gespelde sleutelnaam komt er toch door.

Hoe groot mag een YAML-bestand zijn?

De limiet is 5.000.000 tekens. Gangbare configuratiebestanden zijn in een oogwenk gecontroleerd, en een tekst dichtbij de grens duurt een paar seconden en kost veel geheugen. Daarboven word je gevraagd een kleiner stuk te plakken.

Aanbevolen

Help de tools gratis te houden. ✨

Afbeeldingen dienen ter illustratie. Als Amazon-Partner verdien ik aan in aanmerking komende aankopen.