YAML Söz Dizimi Doğrulayıcı

Hangi YAML kontrol edilir?

Araç js-yaml loadAll ile tek ve çok belgeli akışları ayrıştırır:

name: first
enabled: true
---
name: second
items:
  - one
  - two

Bu örnek iki belge içerir. Söz dizimi kabul edilirse sonuç iki belgenin başarıyla ayrıştırıldığını bildirir. Belge ayırıcıları, blok eşlemeler, diziler ve akış biçimleri YAML söz dizimine göre değerlendirilir.

Ayrıştırıcının davranışı

Araç, js-yaml çözümleyicisini tarayıcınızda çalıştırır ve YAML 1.2 kurallarına uyar. Aynı eşlemedeki yinelenen anahtarlar, bir değeri sessizce değiştirmek yerine hata verir. Çapalar, takma adlar ve birleştirme anahtarları çözümleyici için yapılandırılmış güvenlik sınırları içinde işlenir.

Bir belge okunamazsa sonuç, çözümleyicinin durduğu satır ve sütunu bildirir ve çevresindeki satırları tam o noktanın altındaki bir işaretle yazdırır; böylece doğrudan oraya gidebilirsiniz.

Aynı eşlemede yinelenen anahtarlar hata oluşturur. Anchor ve alias kullanımı ile << birleştirme anahtarları ayrıştırıcı tarafından desteklenen güvenli varsayılan sınırlar içinde işlenir. Bunların söz dizimsel olarak kabul edilmesi, hedef uygulamanızın aynı anlamı kullanacağını garanti etmez.

Göründüğü anlama gelmeyen değerler

Bir dosya tek bir hata bile vermeden okunabilir ve yine de yazdığınızdan başka bir şey saklayabilir. YAML sürprizlerinin çoğu buradan çıkar; bu yüzden akış geçerliyse sonuç, bunun olduğu her satırı listeler:

Tırnak her satırı çözer: zip: "01234" her çözümleyicide metin olarak saklanır. Son sütun, aynı dosyayı PyYAML, Ruby Psych ya da başka bir YAML 1.1 uygulaması da okuduğunda önem kazanır, çünkü ikisi aynı satırı farklı anlayabilir.

Söz dizimi kontrolü, uygulama doğrulaması değildir

Olumlu sonuç YAML metninin bu ayrıştırıcı ve şema ile okunabildiğini söyler. JSON Schema, OpenAPI, Kubernetes, Ansible veya başka bir ürünün alanlarını, gerekli anahtarlarını ve iş kurallarını doğrulamaz. Doğru söz dizimine sahip bir Kubernetes bildirimi yine de eksik veya yanlış bir apiVersion değeri taşıyabilir.

Araç ham verinin ayrıştırılmış ağacını göstermez, biçimlendirme yapmaz, YAML 1.1 seçeneği sunmaz ve dosya yüklemez. Uygulamanızın ayrıca bir şeması varsa bu sonuçtan sonra o uygulamaya özel doğrulayıcıyı kullanın.

Sınırlar ve gizlilik

Girdi 1.000.000 karakteri ve akış 100 belgeyi aşamaz. İlk söz dizimi hatası tüm akışın doğrulamasını durdurabilir; mesajı düzeltip tekrar deneyin. YAML metni, inceleme ve sonuç yalnızca tarayıcıda kalır, sunucularımız üzerinden gönderilmez, URL içine yazılmaz ve geçmişe kaydedilmez. Baştan başlamak geçerli yerel çalışmayı temizler.