JSON ↔ YAML o'zgartirgich — JSON va YAML orasida onlayn o'zgartirish _

JSON ↔ YAML konvertatsiya nima?

JSON (JavaScript Object Notation, RFC 8259) — strukturali ma'lumotlar uchun qat'iy, jingalak qavslar bilan ajratilgan matn formati; YAML (YAML Ain't Markup Language, 1.2 versiyasi) — JSON-ning ustki to'plami bo'lib, xuddi shu qiymat modeli uchun chekinishlar, satr boshlovchilari va inson o'qiy oladigan sintaksisdan foydalanadi. Ular orasida o'tkazish bir xil konfiguratsiyani mashinaga qulay shakldan (API, sxema tekshirish, dasturiy o'zgartirishlar uchun JSON) inson uchun qulay shaklga (kod ko'rib chiqish, Kubernetes manifestlari, GitHub Actions workflow uchun YAML) bir kalitni ham qayta yozmasdan o'tkazish imkonini beradi.

JSON ↔ YAML konvertatsiya qanday ishlaydi?

Har bir konvertatsiya brauzeringizda lokal tarzda kiritilgan js-yaml kutubxonasi (MIT, 4.1.0 versiyasi) yordamida bajariladi. Asosiy bosqichlar:

1. Rejim almashtirgichi (Avtomatik aniqlash / JSON → YAML / YAML → JSON) qaysi quvur ishlashini hal qiladi. Avtomatik aniqlash rejimida kiritishning bo'sh joy bo'lmagan birinchi belgisi yo'nalishni tanlaydi — { yoki [ JSON degani; boshqasi YAML degani.
2. JSON → YAML: JSON.parse kiritishni tekshiradi va JavaScript qiymati hosil qiladi; jsyaml.dump(value, { indent, lineWidth: -1, sortKeys: false }) YAML 1.2 shaklini yozadi. Ko'p hujjatli yoqilganda kirish massivi har bir element bitta hujjat sifatida chiqariladi va --- ajratuvchilari bilan birlashtiriladi.
3. YAML → JSON: jsyaml.loadAll kiritishdagi har bir hujjatni tahlil qiladi (--- ajratuvchilarini avtomatik ravishda ishlaydi) va massivga aylantiradi; bitta hujjatli kirishlar ochiladi, shunda JSON chiqishi bitta elementli massiv emas, hujjatning o'zi bo'ladi.
4. Chekinish (2 yoki 4 bo'sh joy) va Formatlash sozlanadi. Formatlash o'chirilgan holatda JSON.stringify(value) orqali bo'shliqsiz kichraytirilgan JSON chiqariladi.
5. Natija faqat o'qish uchun matn maydoniga yoziladi. YAML tahlil xatoliklarida xato xabari js-yaml ning e.mark orqali xabar qilingan 1-indeksli satr va ustunni o'z ichiga oladi, shunda siz to'g'ridan-to'g'ri xatoga o'tishingiz mumkin.

Nima uchun JSON va YAML-ni shu vosita bilan o'zgartirish kerak?

• Maxfiylik: har bir tahlil, o'zgartirish va chiqarish brauzeringizda bajariladi. Ma'lumotlar — shu jumladan Kubernetes sirlari, imzolangan JWT'lar va shaxsiy konfiglar — serverlarimizga hech qachon yetib bormaydi.
• Ko'p hujjatli YAML: jsyaml.loadAll --- ajratuvchilarini tan oladi va hujjatlar massivini qaytaradi; konvertor bitta hujjatli holatlar uchun uni ochib beradi yoki ko'p hujjatli holatlar uchun JSON massivi sifatida saqlaydi.
• Langarlar va taxalluslar yechilgan: YAML ning &anchor / *alias mexanizmi js-yaml ning standart sxemasi tomonidan ishlab chiqiladi. Bir marta aniqlangan va ikki marta murojaat qilingan qiymat doiraviy almashishda barcha murojaatlar teng qiymatga ega bo'lgan JSON obyektiga aylanadi.
• CDN yo'q, telemetriya yo'q: js-yaml.min.js kutubxonasi sahifa bilan bir xil manbadan jo'natiladi, shuning uchun vosita oflayn, korporativ proksilar orqasida va izolyatsiya qilingan muhitlarda ishlaydi.

JSON ↔ YAML konvertatsiyaning keng tarqalgan qo'llanilishlari qanday?

JSON va YAML orasida o'tish DevOps, platforma muhandisligi va API vositalarida uchraydi:

• Kubernetes manifestlari: YAML Deployment, ConfigMap yoki HelmRelease ni JSON ga o'tkazish, ichki siyosat tekshirgich (Joi, Ajv, OPA Rego) uni dasturiy tarzda tahlil qilishi mumkin, so'ngra klasterga qo'llash uchun yana YAML ga qaytarish.
• CI/CD quvurlari: GitHub Actions workflow.yml ni JSON orqali aylantirib, kod-generator matritsani yoki vazifa bog'liqliklarini qayta yozishi mumkin, so'ngra PR uchun toza YAML chiqariladi.
• OpenAPI spetsifikatsiyalari: backend ning avtomatik yaratilgan hujjatlaridan kelgan JSON openapi.json ni joylashtirib, repo da saqlangan inson tomonidan tahrirlanadigan ma'lumotnoma uchun openapi.yaml ga aylantirish.

JSON ↔ YAML doiraviy almashish misoli qanday ko'rinadi?

{"apiVersion":"apps/v1","kind":"Deployment","metadata":{"name":"web"},"spec":{"replicas":3,"selector":{"matchLabels":{"app":"web"}}}} ni joylashtirib JSON → YAML rejimida O'ZGARTIRISH ni bossangiz, birinchi satrida apiVersion: apps/v1 bo'lgan sakkiz qator chekinishli YAML hosil bo'ladi. Bu YAML ni qaytadan YAML → JSON rejimida Formatlash yoniq holda berish barqaror JSON.stringify(value, null, 2) dan keyin asl obyektni bayt-baytga qaytaradi; kalitlar tartibi saqlanadi, chunki js-yaml ning standart sxemasi ikkala yo'nalishda ham qo'shilish tartibini hurmat qiladi.

Ushbu JSON ↔ YAML o'zgartirgichi to'liq brauzerimda ishlaydimi?

Ha. Har bir tahlil, o'zgartirish va chiqarish brauzer ichida JavaScript sifatida lokal tarzda bajariladi. Kiritilgan js-yaml kutubxonasi sahifa bilan bir manbadan jo'natiladi — CDN yo'q, fetch yo'q, XMLHttpRequest yo'q, kirishda navigator.sendBeacon yo'q. Sahifa yuklangandan keyin vosita oflayn ham ishlaydi, chunki u sotuvchi kutubxona yoniga ko'chirilgan statik HTML/CSS/JS to'plamidir. Kubernetes sirlari, JWT yuklari, imzolangan CloudFormation YAML lari va shaxsiy konfiglar qurilmangizda qoladi.

Konvertor ko'p hujjatli YAML ni qanday ishlaydi?

YAML faqat --- dan iborat satrlar bilan ajratilgan bir oqimda bir nechta hujjatni qo'llab-quvvatlaydi. YAML → JSON da konvertor jsyaml.loadAll ni chaqiradi, bu har bir hujjatni JavaScript qiymati sifatida qaytaradi. Aniq bitta hujjat topilsa, JSON chiqishi bevosita o'sha hujjatdir; ikkita yoki undan ko'p topilsa, JSON chiqishi massivdir. JSON → YAML da, kirish JSON massivi bo'lsa VA Ko'p hujjatli almashtirgichi yoniq bo'lsa, har bir massiv elementi o'rtasida --- ajratuvchilari bilan o'z hujjati sifatida chiqariladi — JSON resurs massivdan kubectl apply ga mos paket yaratish uchun foydali.

YAML langarlari va taxalluslari qo'llab-quvvatlanadimi?

Ha — &anchor ta'riflari va *alias murojaatlari yuklash bosqichida js-yaml ning standart sxemasi tomonidan yechiladi. defaults: &d\n retries: 3\n timeout: 30\njob_a:\n <<: *d\njob_b:\n <<: *d kabi YAML kirishi job_a va job_b ikkalasi retries: 3, timeout: 30 ni o'z ichiga olgan JSON obyektga tahlil qilinadi. Birlashtirish kaliti << (YAML 1.1 kengaytmasi, js-yaml hali ham hurmat qiladi) ham standart sxemada qo'llab-quvvatlanadi.

YAML izohlari JSON ga va orqaga o'zgartirishda saqlanadimi?

Yo'q — js-yaml tahlil bosqichida izohlarni olib tashlaydi, shuning uchun YAML → JSON → YAML doiraviy almashishi har bir # bilan boshlanadigan qatorni yo'qotadi. Bu load/dump modelining ma'lum cheklovi; agar izohlarni saqlash juda muhim bo'lsa, js-yaml o'rniga yaml npm paketi kabi izohlarni biladigan kutubxonadan foydalaning (u qoldiqlarni saqlash uchun mo'ljallangan CST + AST API ni taqdim etadi). Aksariyat konfiguratsiya o'tkazish ish oqimlari uchun kompromiss qabul qilinadi: doiraviy almashishdan keyin YAML har bir kalit, qiymat, langar va taxallusni saqlaydi, faqat muallif yozgan izohlarsiz.

Maxsus YAML teglariga nima bo'ladi?

Konvertor js-yaml ning DEFAULT_SCHEMA sini ishlatadi, u !!str, !!int, !!float, !!bool, !!null, !!seq, !!map, !!binary va !!timestamp ni tushunadi — YAML 1.2 core va JSON sxemalaridagi har bir teg. Maxsus yoki ilovaga xos teglar (masalan, CloudFormation da !Ref, Ansible da !vault) tan olinmaydi va qo'llab-quvvatlanmagan tegni keltirgan aniq xato sifatida ko'rinadi. CloudFormation uchun xususan, ushbu konvertorga joylashtirishdan oldin maxsus teglarni kengaytirish uchun aws cloudformation package + --output-template-file oqimidan foydalaning.

Bu JSON ↔ YAML konvertor js-yaml@4.1.0 bilan bir manbadan to'plangan, ko'p hujjatli oqimlar va langar/taxalluslarni qutidan tashqari qo'llab-quvvatlaydi, manbani tuzata olishingiz uchun YAML tahlil xatoliklarini satr va ustun bilan xabar qiladi. Yuklash yo'q, CDN yo'q, telemetriya yo'q — har bir bayt brauzeringizda qoladi.