Bantuan

Validator YAML: periksa YAML saat Anda mengetik

Tempel YAML Anda, dan validator YAML ini memeriksanya saat Anda mengetik. Setiap kesalahan sintaks dijelaskan dengan bahasa sederhana, lengkap dengan baris dan kolom. Alat ini menemukan indentasi dengan tab, kunci ganda, tanda kutip dan kurung yang belum ditutup, serta spasi tanpa jeda yang tak terlihat dan tampak seperti indentasi padahal bukan. YAML Anda diperiksa di browser Anda dan tidak pernah diunggah.


Cara memakai YAML checker ini langkah demi langkah

Tempel atau ketik YAML Anda di kotak YAML. Tidak ada tombol validasi: teks diperiksa secara langsung.

  1. Teks yang ditempel diperiksa seketika. Saat Anda mengetik, pemeriksaan berjalan sekitar seperempat detik setelah tombol terakhir, sedikit lebih lama untuk teks yang sangat besar. Hasil sebelumnya tetap tampak redup sampai hasil baru muncul.
  2. Baca kotak di bawah editor. Kotak hijau YAML valid berarti sintaksnya benar. Kotak merah “YAML tidak valid” (atau “YAML tidak valid: N masalah”) mencantumkan apa yang salah.
  3. Setiap masalah memuat satu kalimat, “Baris N, kolom M”, dan potongan baris dengan nomor baris: dua baris di atas, satu baris di bawah, dan tanda ^ di bawah kolom.
  4. Pilih Tampilkan di editor untuk memilih baris itu di dalam kotak, perbaiki, lalu lihat kotaknya berubah hijau.

Hanya kesalahan sintaks pertama dari setiap dokumen yang dilaporkan. Kesalahan sesudahnya biasanya efek samping, misalnya tanda kutip yang hilang sehingga baris di bawahnya ikut tertelan. Kunci ganda dan alias yang belum didefinisikan selalu dicantumkan semuanya, dan paling banyak 20 masalah ditampilkan.

YAML error yang umum dan cara memperbaikinya

Setiap error dijelaskan dengan satu kalimat, bukan pesan mentah dari parser. Ini yang paling sering ditemui:

Arti pesan error dari parser lain

Datang dari pesan di terminal atau log CI? Beginilah rumusan yang umum berpadanan dengan apa yang dilaporkan validator ini. Tempel berkas yang sama dan baris-nya akan ditampilkan.

Rumusannya berbeda antarparser (PyYAML, js-yaml, Ruby, Go, loader Home Assistant dan ESPHome), dan parser sering melaporkan baris di bawah kesalahan yang sebenarnya. Validator ini menunjuk baris yang dapat ditampilkannya kepada Anda.

Tab dan karakter tak terlihat

Dua kesalahan YAML yang paling sulit ditemukan adalah yang tidak terlihat. Validator ini membuatnya terlihat.

Contoh: dalam berkas dengan server: dan di bawahnya port: 8080, baris terakhir, host: example.com, diawali dua spasi tanpa jeda, bukan dua spasi biasa. YAML membacanya sebagai kunci tingkat atas tersendiri, dan host bukan anak dari server. Kotak kuning menyebutkan karakter dan barisnya.

Format YAML online dan salin hasilnya

Aktifkan sakelar Rapikan YAML di atas kotak. Sakelar ini mati secara bawaan. Jika teks valid, muncul blok YAML terformat dengan tombol Salin di atasnya, yang berubah menjadi Tersalin setelah menyalin. Hasil rapinya dapat diprediksi:

Hanya YAML yang valid yang bisa dirapikan, jadi berkas yang rusak tidak bisa diperbaiki dengannya: perbaiki dulu errornya. Keluaran yang sangat panjang ditampilkan terpotong setelah 600.000 karakter, dan Salin tetap menyalin semuanya.

YAML lint online: penggunaan, ukuran, dan batasan

Pemeriksaannya sama untuk apa pun kegunaan YAML Anda. Alat ini bisa dipakai untuk alur kerja GitHub Actions, docker-compose.yml, manifes Kubernetes dan nilai Helm, berkas OpenAPI, playbook Ansible, konfigurasi Home Assistant, templat CloudFormation, dan konfigurasi mkdocs. Tempel berkas sebelum commit, dan kesalahan sintaks muncul tanpa menunggu proses CI. Berkas dengan beberapa dokumen yang dipisahkan --- diperiksa dokumen demi dokumen, dan kotak hijau menyebutkan jumlah yang ditemukan. Anchor (&nama) dan alias (*nama) diperiksa. Tag kustom seperti !Ref, !Sub, dan !GetAtt milik CloudFormation, atau !reference milik GitLab, diterima sebagai valid.

Pemeriksaan berjalan di Web Worker pada browser Anda. Berkas konfigurasi, CI, dan Kubernetes yang umum diperiksa dalam sekejap. Batasnya 5.000.000 karakter, dan teks yang mendekatinya butuh beberapa detik dan banyak memori. Di atas batas itu, Anda diminta menempel potongan yang lebih kecil.

Yang diperiksa hanya sintaks YAML. Alat ini tidak tahu apa yang diharapkan sebuah program tertentu, jadi bidang Kubernetes, kunci GitHub Actions atau Docker Compose, dan aturan JSON Schema tidak diperiksa, dan nama kunci yang salah eja tetap lolos. Alat ini mengikuti YAML 1.2, jadi kata yes, no, on, dan off dari YAML 1.1 adalah teks biasa dan tidak pernah dinilai. Alat ini tidak menjalankan, mengambil, atau memuat apa pun, dan satu carriage return Mac lama yang berdiri sendiri tidak dianggap sebagai pemisah baris.

Bekerja dengan format lain? Rapikan dan periksa JSON dengan Pemformat JSON, cocokkan dengan skema memakai Validator JSON Schema, atau periksa markup dengan Validator XML. Mencari pola di konfigurasi Anda? Cobalah di Penguji Regex.


Pertanyaan yang sering diajukan

Bagaimana cara memakai validator YAML online?

Tempel YAML Anda di kotak “YAML”. Teks diperiksa saat Anda menempel atau mengetik, jadi tidak ada tombol yang perlu ditekan. Kotak hijau “YAML valid” berarti sintaksnya benar. Kotak merah “YAML tidak valid” menampilkan setiap masalah dengan bahasa sederhana, lengkap dengan “Baris N, kolom M” dan potongan barisnya.

Mengapa YAML mengatakan tab tidak diizinkan untuk indentasi?

YAML hanya mengizinkan spasi untuk indentasi, dan tab di awal baris adalah kesalahan sintaks. Editor sering menyisipkan tab saat Anda menekan tombol Tab, atau tab ikut tertempel bersama teks. Validator memberi tahu bahwa baris itu menjorok dengan tab. Ganti tab dengan spasi.

Apa arti “mapping values are not allowed here” di YAML?

Biasanya ada titik dua kedua pada satu baris, seperti “a: b: c”, atau nilai tanpa tanda kutip memuat titik dua. Bisa juga baris yang menjorok di bawah kunci yang sudah punya nilai. Letakkan nilai dalam tanda kutip atau tulis pasangan bagian dalam di barisnya sendiri yang menjorok.

Apa arti “did not find expected key” di YAML?

Sebuah baris tidak sejajar dengan kunci lain dalam mapping-nya. Biasanya satu kunci punya spasi lebih banyak atau lebih sedikit daripada kunci di sebelahnya. Beri semua kunci pada tingkat yang sama indentasi yang sama. Validator melaporkannya sebagai baris yang tidak sejajar dengan kunci lain.

Bagaimana menemukan kunci ganda di YAML?

Tempel teksnya. Kunci ganda dalam mapping yang sama selalu dicantumkan semuanya, masing-masing dengan baris dan kolom. Biasanya blok yang disalin meninggalkan kunci berulang. Gabungkan entrinya atau hapus duplikatnya.

Mengapa YAML yang valid menampilkan “Valid, tetapi periksa baris ini”?

Sebuah baris diawali spasi tak terlihat, misalnya spasi tanpa jeda. YAML membacanya sebagai bagian dari kunci, jadi baris itu sebenarnya tidak menjorok walaupun berkasnya valid. Kotak kuning menyebutkan karakter dan barisnya. Hapus dan ketik spasi biasa.

Bisakah saya memeriksa YAML GitHub Actions, Docker Compose, atau Kubernetes di sini?

Bisa, pemeriksaan sintaksnya sama untuk semua YAML. Alat ini berlaku untuk alur kerja, docker-compose.yml, manifes Kubernetes, dan banyak berkas lain. Yang diperiksa hanya sintaks: validator tidak tahu kunci apa yang diharapkan tiap program, dan nama kunci yang salah eja tetap lolos.

Seberapa besar berkas YAML yang bisa diperiksa?

Batasnya 5.000.000 karakter. Berkas konfigurasi yang umum diperiksa dalam sekejap, dan teks yang mendekati batas butuh beberapa detik dan banyak memori. Di atas batas, Anda diminta menempel potongan yang lebih kecil.